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XML BASED SYSTEM FOR UPDATING A DOMAIN MODEL AND 
GENERATING A FORMATTED OUTPUT 

ABSTRACT OF THE DISCLOSURE 

A system for updating a domain model and generating a formatted output is 
disclosed. The system comprises a template driven emitter which processes a template 
file. The template file comprises directives which direct extraction of data from a source 
data model into a target data model. The template file also comprises directives for 
manipulating the DOM tree of the data model. The template driven emitter generates a 
DOM tree for the source data model and a DOM tree for the template file. The template 
driven emitter utilizes the DOM tree to navigate the data model and extract data as 
specified according to the directives in the template file. The template file is written as a 
text file and expressed in XML. 
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XML BASED SYSTEM FOR UPDATING A DOMAIN MODEL AND 
GENERATING A FORMATTED OUTPUT 

A portion of the disclosure of this patent document contains material which 
5 is subject to copyright protection. The copyright owner has no objection to 

the facsimile reproduction by anyone of the patent document or the patent 
disclosure, as it appears in the Patent Office patent files or records, but 
othenA/ise reserves all copyrights whatsoever. 

10 

FIELD OF THE INVENTION 

The present invention relates to object oriented programming systems, and 
more particularly to a system for updating a domain model and generating a fomnatted 
output. 

15 

BACKGROUND OF THE INVENTION 

Hyper Text Markup Language or HTML is synonymous with the Internet and 
the World Wide Web (WWW). HTML allows structural markup of WWW or *Web' 
documents. XML or extensible Markup Language is well known in the art as a document 
- 20 markup language which offers human-readable semantic markup and is also machine- 
readable. As a result, XML provides the capability to create, parse and process networked 
data. 

XML documents are composed of entities, which are storage units containing 
25 text and/or binary data. Text is composed of character streams that form both the 
document's character data content and the document's meta-data markup. The markup 
describes the document's storage layout and logical structure. XML also provides a 
markup mechanism to impose constraints on the storage layout and logical structure of 
documents, and it provides mechanisms that can be used for strong typing. 

30 

In style and structure, XML documents look quite similarto HTML documents. 
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However, when a Web server with XML content prepares data for transmission, the Web 
server must g n rate a context wrapper with each XML fragment, including pointers to an 
associated Document Type Definition (DTD) and one or more style sheets for formatting. 
Clients for the Web server that process XML must be able to unpack the content fragment, 
5 parse the fragment in the context according to the DTD (if needed), render (if needed) in 
accordance with the specified style sheet guidelines, and correctly interpret the hypertext 
semantics (e.g. links) associated with each of the different document tags. It is understood 
that a DTD is not required for an XML document, instead, the author can simply use an 
application-specific tagset. However, a DTD is useful because it allows applications to 
1 0 validate the tagset for proper usage. The DTD specifies the set of required and optional 
elements and their attributes for documents to conform to that type. In addition, the DTD 
specifies the names of the tags and the relationships among elements in a document, for 
example, nesting of elements. 

1 5 One of the main issues during the development of XML was expressing data 

stored in XML documents into various fomnats. This has given rise to the development of 
languages and standards such as XSL and XSLT from W3C. By using an XSL style sheet 
one is able to create an HTML representation of an XML document. Similarly, XSL style 
sheets are used to transform XML documents into an HTML representation. XSL 

20 implementations suffer two principal limitations. First. XSLT requires the definition of rules 
to transform specific types of XML elements into some other type of XML like structure. 
Although the result may simply comprise a stream, the navigation rules must be defined 
based on types and the execution of the navigation rules is based on the degree of 
uniqueness of the navigation. In other words, the execution is not a simple procedural 

25 operation. Secondly, XSLT has no formatting capability which means that formatting is 
perfomned using flow/fomnat objects in XSL and is geared towards HTML forming. 
Therefore, the XSL standards fall short for generating code or non-*ML output from a data 
model. 
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Another issue is concerned with the transformation of XML data. Frequently, 
XML data needs to be transfonned into another valid XML format. This often comprises 
an update activity not a creation activity. The updates are made to specific pre-existing 
XML data, for example, converting selected strings into an altemate format, which is not 
5 the same as creating a new document. To be effective, the transformation needs to 
include an efficient navigation mechanism. 

Accordingly, there remains a need for a mechanism for navigating a data 
model and extracting specific data from the data model. 

10 

BRIEF SUMMARY OF THE INVENTION 

The present invention provides a system for updating a domain model and 
generating a formatted output. The system provides two principal functions: (a) text format 
generation from a source data model; and (b) manipulation of the DOM tree for the domain 
15 model. 

The system provides the capability to navigate a source data model and 
extract specific data from the source data model to a target data model. The system 
utilizes a template driven mechanism and directives are provided to navigate the source 
20 data model and to change the flow of control of the template. The source data model 
includes read-only data that is extracted and used to generate the target data model. 
Directives are also provided to navigate the target data model. 

Through the provision of a set of "structure walking directives" and a set of 
25 basic "string formatting" directives, a user can write a procedural sequence of instructions 
to quickly extract data from a XML source data model (e.g. an XML document) and fonnat 
the extracted data into a desired stream for a target data model. The target data model 
may comprise a simple ASCII file, or an HTML file, or generated content of some other file 
format The mechanism according to the invention provides a target data model without 
30 restrictions. 
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According to anoth r aspect of the invention, the mechanism, i.e. directives, 
is implemented utilizing XML thereby providing a language interface which is natural to 
most users. 

5 In a first aspect, the present invention provides a mechanism for manipulating 

information in a source data model and creating a target data model, the mechanism 
includes, (a) a template module having a directive to manipulate selected data in the 
source data model; (b) a template processing module to process the directive contained 
in the template module; and (c) the template processing module further includes a 
1 0 component to generate a DOM tree for navigating the template module to manipulate said 
source data model. 

In another aspect, the present invention provides a method for manipulating 
selected data in a source data model, the method comprises the steps of: (a) defining a 
15 template file having a directive specifying the data to be extracted from the source data 
model; (b) generating a DOM tree for navigating the template file; and (c) navigating the 
template file and applying the directive to manipulate selected data in the source data 
model. 

20 In yet another aspect, the present invention provides a computer program 

product for an application program for creating objects, the application program includes 
a utility for manipulating information in a source data model and creating a target data 
model, the computer program product comprises: a recording medium; means recorded 
on the medium for instructing a computer to perform the steps of, (a) defining a template 

25 file having a directive specifying the data to be extracted from the source data model; (b) 
generating a DOM tree for navigating the template file; and (c) navigating the template file 
and applying the directive to manipulate selected data in the source data model. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

Reference will now be mad to the accompanying drawings which show, by 
way of xample. pr f rr d embodiments of the present invention and in which: 

5 Fig. 1 shows in diagrammatic form a system for updating a domain model 

and generating a fomriatted output in accordance with the present invention; 

Fig. 2 shows in flowchart fomn the method steps for processing directives 
according to the present invention; 

10 

Fig. 3 shows in flowchart form the method steps for executing directives 
according to the present invention; 

Fig. 4 shows in flowchart form the method steps for resolving a macro 
15 according to the present invention; 

Fig. 5 shows in flowchart fonn the method steps for resolving scoping 
according to the present invention; 

20 Fig. 6 shows in diagrammatic form a formatted output generated according 

to the present invention; and 

Fig. 7 shows in diagrammatic fomi a domain model manipulation example 
according to the present invention. 

25 
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DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 

Reference is first made to Fig. 1 which shows in diagrammatic form a 
mechanism according to the present invention for updating a domain mod I and generating 
a formatted output. The mechanism comprises a template-driven implementation. In the 
5 preferred embodiment, the mechanism is in an application development program for 
creating objects, etc., according to object-oriented principles and the domain models and 
trees define an object model. 

The mechanism is indicated generally by reference 10 and comprises a 
10 template file or module 12 and a template driven emitter or template processing module 
14. As will be described in more detail below, the template driven emitter 14 applies the 
template file 1 2 to a domain model 1 6 to produce a generated output file 1 8. In the context 
of the present invention, the domain model 16 comprises a source data model and the 
generated output file 18 comprises a target data model. The source data model 16 
1 5 contains read-only data which is extracted by the mechanism 1 0 and used to generate a 
formatted output, i.e. the target data model 18. The target data model 18 contains both 
read/write data that is manipulated by the mechanism 10. According to the invention, the 
mechanism 10 provides the capability to navigate the data models 16, 18 and also 
manipulate the target data model 18. 

20 

The template file 12 is created as a text file with directives that navigate the 
source data file 16 and navigate and manipulate the target data file 18. While the 
mechanism 10 is described in the context of an XML based data model 16. the mechanism 
10 is not concerned with the structure of the model 16. The template file 12 is created 
25 using a conventional editor. The mechanism 1 0 only responds to navigational, substitution 
and emit directives contained in the template files 12. As will be described in more detail 
below, the data model 16 is traversed in a symbolic fashion, i.e. naming the object 
relationships as strings, rather than direct object references. The attribute values are 
retrieved in the same fashion, i.e. by naming the attribute in a string. 

30 
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In the preferred embodiment, the template file 12 is expressed in XML format 
and comprises directives and macros. The specification of the document type definition 
(DTD) for the templat file 12 is provided b low in Appendix I. The directives are 
commands or rules that define the flow of control. The macros provide for string 
5 manipulation. The mechanism 10 includes domain model navigation directives, domain 
model manipulation directives, output manipulation directives, logical operation directives, 
and code section directives. The domain model navigation directives are used to navigate 
the domain model (i.e. the source data model 16), The domain model manipulation 
directives are used to modify the domain model (i.e. target data model 18). The output 
10 manipulation directives are used to modify the generated output in the target data model 
18. The logical operation directives are used to change the logical processing of a 
template file 12. The code section directives are used to maintain code sections in the 
generated output (i.e. target data model 18). A full listing of the directives is provided 
below in Appendix II. 

15 

As described above, the source data model (i.e. domain model 16 in Fig. 1) 
contains read-only data that the mechanism 10 can extract and use to generate a 
formatted output (i.e. the target data model 1 8). A feature of the mechanism 1 0 according 
to the present invention is the ability to manipulate the target data model 18. According 
20 to this aspect of the invention, the target data model 1 8 contains read/write data which can 
be manipulated according to directives contained in the template file 12. Afull listing of the 
directives is provided below in Appendix II, and directives for manipulating the target data 
model 18 include updatetargetscope, targetscope, addtargetscope, and 
removetargetscope. 

25 

The updatetargetscope directive Is used to update an element of a DOM tree 
associated with a domain model. If the element does not exist it is inserted into the DOM 
tree. The syntax for the updatetargetscope directive is shown below in Appendix II. The 
following example describes the operation of the updatetargetscope directive: 

30 
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Suppose the model defines an element "Class" which has two other emb dded elements. 
This document (i.e th source data file 16) Is called "class.xml ". 

class.xml 

<Class name="Set"> 
<Method name="add"> 
</Method> 

<Method name="del"> 

</Method> 

</Class> 

Also consider the following template (i.e. template file 12): 
<?xml version="1 .0"?> 

<!DOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<„TDEBIock_ DOMTree="class.xmr'> 
<define MACRO=newMethodName>addNew</define> 
<targetscope NAME="Method"> 
<updatetargetscope NAME="name" 

TYPE='ATTRIBUTE ">$newMethodName$</updatetargetscope> 

</targetscope> 

</_TDEBIock_> 

The resulting DOM tree when the template is applied to the document "class.xml" 
is as follows: 

<Class name="Set"> 
<Method name="addNew"> 
</Method> 

<Method name="del"> 

</Method> 

</Class> 
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It will be appreciated that the name of the first method changes from "add" to "addNew". 

Th targetscope directive Is us dtonavigat to an element that Is part of an 
existing DOM tree associated with . The syntax for the targetscope directive Is described 
5 below In Appendix II. The following example illustrates the operation of the targetscope 
directive: 

Suppose the model defines an element "Class" which has two other embedded elements. 
This document (i.e. the source data file 16} is called "class.xml". 

10 

class.xml 
<Classllst> 
<Class name="Set"> 
<Method name="add"> 
15 </Method> 

<Method name="del"> 
</Method> 
</Class> 
</Classllst> 

20 

Also consider the following template (I.e. the template file 12): 
<?xml verslon="1.0"?> 

<!DOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_ DOMTree="ciass.xmr'> 
25 <targetscope NAME="Class"> 

</targetscope> 
</_TDEBIock_> 

The template driven emitter 14 navigates to the Class element in the class.xml document. 
30 It will be understood that no emitted output is created since this directive just navigates the 
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target data model 18 (i.e. the target document). In this case the targeted XML document 
is class.xml. 

The addtargetscope directive is used to insert an element into a DOM tree 
5 associated with a domain model. The syntax for the addtargetscope directive is described 
below in Appendix II. The following example illustrates the operation of the addtargetscope 
directive. 

Suppose the model defines an element "Class" which has two other embedded elements. 
10 This document (i.e. the source data file 16) is called "class.xml". 

class.xml 
<Classlist> 
<Class name="Set"> 
1 5 <Method name="add"> 

</Method> 

<Method name="der'> 
</Method> 
</Class> 
20 </Classlist> 

Also consider the following template (i.e. the template file 12): 
<?xml version="1.0"?> 

<!DOCTYPE _TDEBIock_ SYSTEM "dtdAde.dtd"> 
25 <_TDEBIock_ DOMTree="class.xmr'> 

<targetscope NAME="Class"> 

<addtargetscope NAME="Method"> 

<addtargetscope NAME="Argument"></addtargetscope> 

</addtargetscope> 
30 </targetscope> 
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</_TDEBIock_> 

The resulting DOM tree when the template is applied to the docum nt "class.xml" is as 
follows: 
5 <ClassList> 

<Class name="Set"> 
<Method> 
<Argunnent/> 
</Method> 
10 <Method name="add"> 

</Method> 

<Method nanne="del"> 
</Method> 
</Class> 
15 </Classlist> 

The removetargetscope directive is used to delete an element from a DOM 
tree associated with a domain model. The syntax for the removetargetscope directive is 
shown below in Appendix II. The following example describes the operation of the 
20 removetargetscope directive: 

Suppose the model defines an element "Class" which has two other embedded elements. 
This document (i.e. the source data file 16} is called "class.xml". 

25 class.xml 

<Class name="Set"> 
<Method name="add"> 
</Method> 

<Method name="del"> 
30 </Method> 
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</Class> 

Also consider the following t mplate (i.e. the tempiat file 12): 
<?xml version="1.0"?> 
5 <!DOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 

<_TDEBIock_ DOMTree="class,xml"> 
<removetargetscope NAME="Method'7> 
</_TDEBIock_> 

10 The result of when the template is applied to the document "class.xml" is as follows: 
<Class name="Set"> 
<Method name="der> 
</Method> 
</Class> 

15 

It will be appreciated that the first method element was removed. Since no index was 
specified the default value for the index is 0. 

It will be appreciated that these directives are very useful in applications, such 
20 as "Web" applications and database applications, which require updating of a model stored 
in XML or a model stored in a database. The other directives included in the mechanism 
10 according to the present invention are described below in Appendix II. 

The mechanism 10 also includes XML specific directives such as 
25 updatetargetdoctype. These XML specific directives are for working with data models that 
are stored as XML (unlike other directives which are not XML data model specific). 

The updatetargetdoctype directive is used to update the IDOCTYPE element 
of a DOM tree associated with a domain model. If the element does not exist it is inserted 
30 into the DOM tree. The syntax of the updatetargetdoctype is described in Appendix II 
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below. The operation of the updatetargetdoctype is illustrated by the following example 
which involv s adding a sinnple IDOCTYPE element (additional examples are provided in 
Appendix II). 

Consider the following template file: 
<?xml version="1.0"?> 

<!DOCTYPE _TDEBIock_ SYSTEM "../../../.7dtd/tde.dtd"> 
<_TDEBIock_> 

<updatetargetdoctype PUBLIC_NAME="Chemistry" 

PUBLIC_URL="http://sunsite.unc.edu/public/chemistry.dtd" 

ROOT_ELEMENT_NAME="myroofV> 

</_TDEBIock_> 

The result of when the template is applied is as follows: 
<?xml version="1.0" standalone="no'7> 
<!DOCTYPE myroot PUBLIC "Chemistry" 
"htlp://sunsite.unc.edu/public/chemistry.dtd"> 

The mechanism 10 according to the present invention also includes macro 
transformations. A macro associates a name with a set of values and enables string 
substitution within the template file 12. The macro transformations are useful in situations 
that require text to be changed to uppercase, lowercase, truncated, etc. The following 
macro transformations are provided in the mechanism 10: toupper, tolower, truncate, 
separate, strip, stripTrailing, stripLeading, change in j)attem out j>attem, numWordis, 
wordsp], and wordp]. 

The toupper macro converts the macro value to all upper case letters. If an 
optional parameter T (as described in Appendix II) is specified, then only the i'th character 
is converted to upper case. The tolower macro converts the macro value to all lower case 
letters. If the optional parameter T is specified in that case, then only the i'th character is 
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converted to lower case. The truncate macro truncates the macro value to a specified 
parameter 'maxlen' characters long by r moving vowels. If no maxlen param ter is 
specified, th n the macro truncates to the default of 8 characters. The separate macro 
separates the values in a multivalue macro by separator. If the separator is a 
5 string/character, the separator must be enclosed by quotes OthenA/ise it is assumed to 
be a macro name and the value of that macro is used as the separator. It is to be noted 
that when used in a <repeat> statement, repeat blocks are separated by a separator. The 
strip macro removes ail leading and trailing white space characters from the macro value. 
If a string pattem is specified (either as a string or a macro name), the pattern will be 

1 0 stripped off from the macro value. The stripTrailing macro removes all trailing white space 
characters from the macro value. An optional pattern to strip may be specified. The 
stripLeading macro removes all leading white space characters from the macro value. An 
optional pattern to strip may be specified. The change inj)attem outjDattern macro 
replaces every occurrence of the inj>attern in the macro value with out_pattem. 

1 5 Strings/characters must be enclosed by quotes, otherwise the parameter is assumed to be 
a macro name and the value of that macro will be used. The increment macro increments 
the value of the macro by one. If an optional parameter T is specified, then the increment 
step is defined by T. The numWords macro returns the number of words in a string. For 
example, if the string contains "This is an apple pie", then the macro numWords returns 

20 *5'. The words[il macro returns the string after the i'th word inclusively. For the previous 
example, words [3] would return "an apple pie". The word[il macro returns the ith word in 
a string. For the previous example, the macro word[31 would return "an". The macro 
transformations included in the mechanism 10 according to the present invention are 
further described in Appendix II. 

25 

According to another aspect, the mechanism 10 utilizes a "tree" navigation 
scheme to perfomi transformations in the source data model 1 6 (and the target data model 
18). As will be described in more detail below, to apply a transformation to a node in the 
data model 16 or 18, the mechanism 10 first navigates the root node for the data model. 
30 then down to the child node until the specific node of interest is located. Once located, the 
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transformation rule(s) is applied to the node. As tree navigation is not data model specific, 
th mechanism 10 according to the present invention is advantageously flexible and can 
support various data model types other than XML. 

5 The mechanism 10 also includes a facility for code sections. The code 

sections are analogous to methods and have application for reusing templates, or for 
overriding other code sections with the same name. The code sections comprise the 
directives code and call, which are described in more detail in Appendix II. 

10 Reference is next made to Figs. 2 to 5 which show the method steps 

embodied in processing the template file 12 according to the present invention. 

Fig. 2 shows in flow chart form the method steps embodied in the mechanism 
1 0 for processing directives according to the present invention. The method steps comprise 

1 5 a process which is indicated generally by reference 1 00 in Fig. 2. As described above, the 
directives for navigating and/or manipulating the data model are contained in the template 
file 12 (Fig. 1). and the template file 12 is processed by the template driven emitter 14 (Fig, 
1). The first step as indicated by block 110 in Fig. 2 involves initializing the template driven 
emitter 14. which in the preferred embodiment is capable of processing XML documents 

20 and templates. Initialization of the template driven emitter 14 includes the following 
operations: creating and populating a macro table with predefined macros (which will be 
used for string substitution in the template file) and creating a code section table (which will 
be populated with code sections, defined by name using the code directive, that will be 
emitted on the occurrence of a call directive using the code sections' name(s)). 

25 Additionally, the template driven emitter generates a DOM tree for the template file and for 
the source data model, both trees used for navigating respectively the template file and the 
source data model. DOM or document object model is an API for HTML and XML 
documents established through the W3C Organization. DOM defines the logical stojcture 
of documents and the way a document is accessed and manipulated. See 

30 http://www.w3.org/dom for more infomfiation. As used herein, DOM trees are understood 
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as used in the context of the DOM specification but need strictly follow the DOM 
specification. Indeed, as used herein, DOM trees could be trees according to conventional 
understandings or defined according to other non-DOM specifications. 

5 The next step (block 1 12) in the process 100 involves getting the first or next directive from 
the template file 12. As described above, the template file 12 is created as a text file with 
the directives specified according to the definitions contained in Appendix II. The next step 
in decision block 114 involves ascertaining whether the directive is a directive for the 
template driven emitter 14, (It will be appreciated that only template driven emitter 

10 directives can drive the operation of the template driven emitter 14.) If the directive 
retrieved in step 112 is not a template driven emitter (TDE) directive, then a check 
(decision block 128) is made to determine if there any further directives in the template file 
12. If no, then the process 100 for processing the template file 12istenninated. If yes, then 
the next directive in the template file 12 is retrieved (step 1 12) and a check is made to 

1 5 ascertain if the directive is a TDE directive (decision block 114). 

Referring to Fig. 2, if the directive is a TDE directive (as determined in 
decision block 1 14), then the next step (block 1 16) in the process 100 involves parsing the 
content of the directive for any macros which may be included. If the content does include 

20 a macro value (decision block 118). then a process 300 for resolving the macro name is 
invoked in the block 120. The result of the macro name process 300 is a macro value for 
the macro name. The macro name resolving process 300 is described below with 
reference to Fig. 4. As shown in Fig. 2, the next step in the process 100 involves 
determining if the macro value returned from the process 300 requires scoping (decision 

25 block 1 22). if the macro value requires scoping , then a process 400 for scoping the macro 
value is invoked in block 130. The macro value scoping process 400 is described in more 
detail below with reference to Fig. 5. Once the macro value has been scoped, the directive 
is executed as indicated by block 124 in Fig. 2. If the macro value does not require 
scoping as determined in decision block 122, then the next step is also executing the 

30 directive in block 124. If the directive does not contain a macro value as determined in 
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decision block 1 18, then processing also proceeds to executing the directive in block 124. 
In block 124, the directive is executed 200 as will be described in more d tail with 
reference to Fig. 3 below. The result of xecuting the directive, i.e. content, is written to an 
output buffer as indicated in block 126. Next, a check is made in decision block 128 to 
5 ascertain if there any more directives in the template file 12. If there are more directives 
in the template file 12, then the processing steps starting at block 112 are repeated as 
described above. If there are no more directives, then the processing of the template file 
12 is completed and the process 100 ends. 

1 0 The processing of the template file 1 2 (Fig. 1 ) is implemented in the template 

driven emitter 14 (Fig. 1 ) as will be apparent to one skilled in the art based on the foregoing 
description. 

Reference is next made to Fig. 3, which shows the method steps embodied 
15 in a process for executing the directive as indicated by block 124 (Fig. 2). As shown in Fig. 
3, the process for executing the directives is indicated generally by reference 200. The 
directives are processed according the definitions found in Appendix II. The first operation 
in the process 200 involves pushing the current directive context onto a stack as indicated 
in block 210. Next, the start tag of the directive is processed (block 212) by, among other 
20 things, parsing the directive and performing the steps required to execute the action of the 
directive in accordance with the relevant definitions found in Appendix II. It should be 
apparent to those skilled in the art how to implement the specifications and definitions of 
Appendix II. The next operation involves determining if the directive contains any 'children' 
in decision block 214. If there is a child, then the current context is set to the child directive 
25 in block 216, and pushed onto the stack in block 210. The steps in blocks 212 and 214 are 
repeated in order to navigate the DOM tree. 

Referring to Fig. 3, if the directive does not contain a child or any more 
children (as determined in decision block 214). then the end tag of the directive is 
30 processed in block 218. The last operation in the directive processing involves popping the 



CA9.1 999-0037 



17 



CA 02311870 2000-06-15 



current directive context from stack (which was pushed in block 210) to restore the state 
data, as indicated in block 220. After this step, the directiv processing is ended. 

Reference is next made to Fig. 4 which shows the method steps embodied 
5 in a process for resolving the macro name as indicated by block 120 (Fig. 2). As shown 
in Fig. 4, the process for resolving the macro name is indicated generally by reference 300. 
The first step in resolving the macro name process 300 involves ascertaining if the macro 
name is stored in the macro table, as indicated by decision block 310, If the macro name 
is contained in the macro table, then the value for the macro name is extracted from the 
10 macro table, as indicated in block 312, and the process 300 is completed. If the macro 
name is not stored in the macro table (decision block 310), then a check is made to 
ascertain if the macro name is stored in the domain model, as indicated in decision block 
314. If the macro name is stored in the model, then the value for the macro name is 
extracted from the model, as indicated in block 316, and the process 300 for resolving the 
15 macro name is completed. If the macro name is not stored in the model (as determined in 
decision block 314), then the value for the macro name is set to the name encased by a 
character in the template file 12. After step 318, the process 300 is completed. 

Reference is next made to Fig. 5, which shows the method steps embodied 
20 in a process for resolving the scoping of the macro name as indicated by block 1 30 (Fig. 
2). As shown in Fig. 5, the process for resolving the scoping of the macro name, i.e. 
navigating the DOM tree, is indicated generally by reference 400. The first step in the 
process 400 for resolving the scope of the macro name involves processing the root scope 
name in block 41 0. Next, a determination is made in decision block 41 2 to determine if the 
25 scope refers to a child node in the DOM tree for the model. If the scope is a child node, 
then the scope context is moved to the child node, as indicated in block 414. After step 
414, a check is made in decision block 416, to determine if the scope name contains any 
additional scopes. If there are additional scopes, then the scope name is processed in 
block 410 and decision block 412 as described above. 

30 
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Referring to Fig. 5, if the scope name does not refer to a child node (as 
determined in decision block 412), then a check is made in d cision block 41 8 to ascertain 
if the scope name refers to a parent node in the DOM tre . If yes, then the scop context 
is moved to the parent node as indicated in block 420. After this step, a check is made to 
5 ascertain if the scope name contains additional scopes in decision block 41 6, as described 
above. If the scope name does not correspond to the parent node (decision block 418), 
then a check is made in decision block 422 to determine if the scope name refers to the 
root node in the DOM tree. If the scope name refers to the root node, then the scope 
context is moved to the root node, as indicated by block 424. Next, a check is made in 
1 0 decision block 4 1 6 to detemriine if the scope name contains additional scopes as described 
above. 

The operation of the mechanism 10 according to the present invention is 
further described with reference to two examples depicted in Fig. 6 and Fig. 7, respectively. 

15 

Reference is made to Fig. 6, which depicts a formatted output file 28 
generated from a source data file 26 according to a template file 22. The template file 22 
is processed according to a template driven emitter 24. The arrangement of the template 
file 22 and the template driven emitter 24 are as described above. In operation, the 

20 template driven emitter 24 reads the source data file 26 and creates a DOM tree. The 
template driven emitter 24 also reads the template file 22 and creates a DOM tree (as 
described above). When the template file 22 is first processed, the template driven emitter 
24 sets the current context to the root element in both DOM trees. Subsequently, 
navigation of the DOM tree is controlled by the scope directive(s) contained in the template 

25 file 22. As shown in Fig. 6, the template file 22 defines the root element as TDEBIock' 
(Line 3). In Line 4, the template file 22 includes a directive which defines the formatted 
output file 28 named by a macro value. Line 6 of the template file 22 includes a scope 
directive which changes the context (i.e. navigates the DOM tree) to the 'Method*. As 
shown in Fig. 6, the generated output in the output file 28 is indicated by Void add()' in Line 

30 2. The output file 28 is stored under the name 'Set.java', which was defined by the 'outfile' 
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directive in the template file 22 (Line 4). 

Referenc is next mad to Fig. 7, which shows an example of a DOM tree 
manipulation according to the present invention. As shown in Fig. 7, the template driven 
5 emitter 34 processes a template file 32 which modifies a source data file 36 to generate 
an output file 38. The output file 38 comprises the source file 36 associated with a 
modified DOM tree. As shown in Fig. 7, the template file 32 includes an 'addtargetscope' 
directive in Line 4 and another 'addtargetscope' directive in Line 5. As described above, 
the addtargetscope directive is used to insert an element into the DOM tree. For the 

1 0 template file 32, the first directive directs the addition of an element called 'Method' to the 
DOM tree. The second directive in the template file 32 directs the addition of an attribute 
'name' to the element 'Method'. The element 'Method' with the attribute 'name' appears in 
Line 7 of the generated output file 38 as shown in Fig. 7. It will be appreciated that the data 
model is navigated in a symbolic manner, i.e. naming the object relationships as strings. 

1 5 rather than direct object references. Similarly, the attribute values are retrieved by naming 
the attribute string. 

The detailed descriptions may have been presented in temis of program procedures 
executed on a computer or network of computers. These procedural descriptions and 
20 representations are the means used by those skilled in the art to most effectively convey 
the substance of their work to others skilled in the art. They may be implemented in 
hardware or software, or a combination of the two. 

A procedure is here, and generally, conceived to be a self-consistent 
25 sequence of steps leading to a desired result. These steps are those requiring physical 
manipulations of physical quantities. Usually, though not necessarily, these quantities take 
the forni of electrical or magnetic signals capable of being stored, transfenred, combined, 
compared, and othenvise manipulated. It proves convenient at times, principally for 
reasons of common usage, to refer to these signals as bits, values, elements, symbols, 
30 characters, terms, numbers, objects, attributes orthe like. It should be noted, however, that 
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all of these and similar terms are to be associated with the appropriate physical quantities 
and are merely conveni nt labels appli d to these quantities. 

Further, the manipulations performed are often referred to in temns, such as 
5 adding or comparing, which are commonly associated with mental operations performed 
by a human operator. No such capability of a human operator is necessary, or desirable 
in most cases, in any of the operations described herein which form part of the present 
invention; the operations are machine operations. Useful machines for performing the 
operations of the present invention include general purpose digital computers or similar 
10 devices. 

Each step of the method may be executed on any general computer, such 
as a mainframe computer, personal computer or the like and pursuant to one or more, or 
a part of one or more, program modules or objects generated from any programming 
15 language, such as C++, Java, Fortran or the like. And still further, each step, or a file or 
object or the like implementing each step, may be executed by special purpose hardware 
or a circuit module designed for that purpose. 

In the case of diagrams depicted herein, they are provided by way of 
20 example. There may be variations to these diagrams or the steps (or operations) described 
herein without departing from the spirit of the invention. For instance, in certain cases, the 
steps may be performed in differing order, or steps may be added, deleted or modified. All 
of these variations are considered to comprise part of the present invention as recited in 
the appended claims. 

25 

Throughout the description and claims of this specification, the word 
•^comprise" and variations of the word, such as "comprising" and "comprises", is not 
intended to exclude other additives, integers or processed steps. 

30 While the preferred embodiment of this invention has been described in 
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relation to the XML language, this invention need not be solely operate using the XML 
languag . It will be apparent to those skilled in the art that th invention may equally be 
operable with other computer languages, such as SGML. 

5 The invention is preferably implemented in a high level procedural or object- 

oriented programming language to communicate with a computer. However, the invention 
can be implemented in assembly or machine language, if desired. In any case, the 
language may be a compiled or interpreted language. 

1 0 While aspects of the invention relate to certain computer language and other 

technological specifications (e.g . the XML specification), it should be apparent that classes, 
objects, components, tags and other such software and technological items referenced 
herein need not fully conform to the specification(s) defined therefor but rather may meet 
only some of the specification requirements. Moreover, the classes, objects, components, 

15 tags and other such software and technological items referenced herein may be defined 
according to equivalent specification (s) other than as indicated herein that provides 
equivalent or similar functionality, constraints, etc. For example, instead of the XML 
language specification, tags and other such software and technological items referenced 
herein may be defined according to the SGML specification where applicable and 

20 appropriate. 

The invention may be implemented as a mechanism or a computer program 
product comprising a recording medium. Such a mechanism or computer program product 
may include, but is not limited to, CD-ROMs, diskettes, tapes, hard drives, computer RAM 

25 or ROM and/or the electronic, magnetic, optical, biological or other similar embodiment of 
the program. Indeed, the mechanism or computer program product may include any solid 
or fluid transmission medium, magnetic or optical, or the like, for storing or transmitting 
signals readable by a machine for controlling the operation of a general or special purpose 
programmable computer according to the method of the invention and/or to structure its 

30 components in accordance with a system of the invention. 
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The invention may also be implemented in a system. A system may comprise 
a comput r that includes a processor and a memory d vice and optionally, a storage 
device, an output device such as a video display and/or an input device such as a 
5 keyboard or computer mouse. Moreover, a system may comprise an interconnected 
network of computers. Computers may equally be in stand-alone fonn (such as the 
traditional desktop personal computer) or integrated into another apparatus (such a cellular 
telephone) . The system may be specially constructed for the required purposes to 
peri'orm, for example, the method steps of the invention or It may comprise one or more 
1 0 general purpose computers as selectively activated or reconfigured by a computer program 
in accordance with the teachings herein stored in the computer(s). The procedures 
presented herein are not inherently related to a particular computer system or other 
apparatus. The required structure for a variety of these systems will appear from the 
description given. 

15 

While this invention has been described in relation to prefen^ed embodiments, 
it will be understood by those skilled in the art that changes in the details of construction, 
arrangement of parts, compositions, processes, structures and materials selection may be 
made without departing from the spirit and scope of this invention. Many modifications and 
20 variations are possible in light of the above teaching. Thus, it should be understood that 
the above described embodiments have been provided byway of example rather than as 
a limitation and that the specification and drawing(s) are, accordingly, to be regarded in an 
illustrative rather than a restrictive sense. 



CA9-1 999-0037 



23 



CA 02311870 2000-06-15 



APPENDIX I 

DTD Specifications 

5 <?xml encoding="US-ASCII"?> 

<!ENTITY % tdechildren "(#PCDATA | outfile | define | clear | if | repeat | 
scope I repeatscope | createalias | 

include | code | call | sameline | assert | ifhasscope | ifhasrepeatscope | 
hasscope | targetscope )*" > 
10 <IENTITY % targettdechildren "(#PCDATA | outfile | define | clear | if | repeat 
I scope I repeatscope | createalias | 

include | code | call | sameline | assert | ifhasscope | repeattargetscope | 
ifhasrepeatscope | hasscope | updatetargetscope | addtargetscope | 
removetargetscope | ifhastargetscope ] ifhasrepeattargetscope | hastargetscope | 
1 5 targetscope | updatetargetdoctype )*" > 

<!ENTITY % ifhastdechildren "(#PCDATA | outfile | define | clear | if | else | 
repeat | scope | repeatscope | createalias | 

include | code | call | sannellne | assert | ifhasscope | repeattargetscope | 
ifhasrepeatscope | hasscope | updatetargetscope | addtargetscope | 
20 removetargetscope | ifhastargetscope | ifhasrepeattargetscope | hastargetscope | 
targetscope | updatetargetdoctype )*" > 

<!ENTITY % elsetdechildren "(#PCDATA | outfile | define | clear | if | repeat | 
scope I repeatscope | createalias | 

include | code | call | sameline | assert | ifhasscope | ifhasrepeatscope | 
25 hasscope | else | targetscope )*" > 

<IELEMENT define ( #PCDATA ) > 

<IATTLIST define MACRO CDATA#REQUIRED> 

<!ELEMENT clear EMPTY > 

<!ATTLIST clear MACRO CDATA #REQUIRED> 
30 <IELEMENT .TDEBIock_ %targettdechildren; > 
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<!ATTLIST _TDEBIock_ DOMTree CDATA #IMPLIED> 

<!ELEMENT updat targ tdoctype EMPTY > 

<!ATTLIST updatetargetdoctype SYSTEM_URL CDATA #IMPLIED> 

<!ATTLIST updatetargetdoctype PUBLIC_URL CDATA #IMPLIED> 
5 <!ATTLIST updatetargetdoctype PUBLIC_NAME CDATA #IMPLIED> 

<!ATTLIST updatetargetdoctype ROOT_ELEMENT_NAME CDATA #IMPLIED> 

<!ELEMENTif %elsetdechildren; > 

<!ATTLIST if EXPRESSION CDATA #REQUIRED> 

<!ELEMENT else EMPTY > 
10 <IELEMENT addtargetscope %targettdechildren; > 

<!ATTLIST addtargetscope NAME CDATA #REQUIRED> 

OATTLIST addtargetscope TYPE (ELEMENT | ATTRIBUTE) "ELEMENT'> 

<!ATTLIST addtargetscope INDEX CDATA #IMPLIED > 

<1ELEMENT updatetargetscope %targettdechildren; > 
1 5 OATTLIST updatetargetscope NAME CDATA #REQUIRED> 

<!ATTLIST updatetargetscope TYPE (ELEMENT | ATTRIBUTE) "ELEMENr> 

<!ATTLIST updatetargetscope INDEX CDATA #IMPLIED > 

<!ELEMENT repeattargetscope %targettdechildren; > 

<!ATTLIST repeattargetscope NAME CDATA #REQUIRED> 
20 <!ELEMENT removetargetscope EMPTY > 

<!ATTLIST removetargetscope NAME CDATA #REQUIRED> 

<!ATTLIST removetargetscope TYPE (ELEMENT | ATTRIBUTE) "ELEMENr'> 

<!ATTLIST removetargetscope INDEX CDATA #IMPLIED > 

<!ELEMENT targetscope %targettdechildren; > 
25 <!ATTLIST targetscope NAME CDATA #REQUIRED> 

<!ATTLIST targetscope INDEX CDATA #IMPLIED > 

<!ELEMENT hastargetscope %targettdechildren; > 

<!ATTLIST hastargetscope NAME CDATA #REQUIRED> 

<!ATTLIST hastargetscope INDEX CDATA #IMPLIED > 
30 <!ELEMENT Ifhastargetscope %ifhastdechildren; > 
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<!ATTLIST ifhastargetscope NAME CDATA #REQUIRED> 
<!ATTLIST ifhastarg tscope INDEX CDATA #IMPLIED > 
<!ELEMENT ifhasrepeattargetscope %ifhastdechildren; > 
<!ATTLIST ifhasrepeattargetscope NAME CDATA #REQUIRED> 
5 <!ELEMENT repeat %tdechilclren; > 

<!ATTLIST repeat MACRO CDATA #REQUIRED> 
<!ELEMENT repeatscope %tdechildren; > 
<!ATTLIST repeatscope NAME CDATA #REQUIRED> 
<!ELEMENT scope %targettdechildren; > 

1 0 <!ATTLIST scope NAME CDATA #REQUIRED> 
<!ELEMENT include EMPTY > 
<!ATTLIST include FILENAME CDATA #REQUIRED> 
<IELEMENT outfile %tdechlldren; > 
<!ATTLIST outfile FILENAME CDATA #REQUIRED> 

1 5 <IATTLIST outfile MODE CDATA #IMPLIED> 
<!ELEMENT code %tdechildren; > 
<!ATTLIST code NAME CDATA #REQUIRED> 
<!ELEMENT call %tdechildren; > 
OATTLIST call NAME CDATA #REQUIRED> 

20 <!ATTLIST call MACROLIST CDATA #IMPLIED> 
<IELEMENT sameline %tdechildren; > 
<!ELEMENT assert EMPTY > 

<IATTLIST assert EXPRESSION CDATA #REQUIRED> 
<!ELEMENT ifhasrepeatscope %ifhastdechildren; > 

25 <!ATTLIST ifhasrepeatscope NAME CDATA #REQUIRED> 
<IELEMENT hasscope %tdechildren; > 
OATTLIST hasscope NAME CDATA #REQUIRED> 
<IELEMENT ifhasscope %ifhastdechildren; > 
OATTLIST ifhasscope NAME CDATA #REQUIRED> 

30 <IELEMENT createalias %targettdechildren; > 
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<!ATTLIST createaiias ALIASNAME CDATA #REQUIRED> 
<!ATTLIST createaiias ALIASPATH CDATA #REQUIRED> 
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APPENDIX II 

The preferred embodiment of the mechanism according to the present invention for 
5 updating a domain model and generating a fomiatted output works with an XML model, 
however, the mechanism is unaware of the structure of the model. It only responds to 
navigational, substitution and emit directives contained in the templates. The model is 
traversed In a symbolic fashion (i.e. naming the object relationships as strings, rather than 
direct object references), and the attribute values are retrieved in the same fashion (i.e. by 
10 naming the attribute in a string). 

Language Specification 

Introduction 

For ease of use, the template language is a simple language that has a well formed XML 
15 syntax. The language consists of the following constructs: 

1 . Text. Text is emitted as is. Blanks are treated as text; any indentation that occurs in the 
template file will be echoed in the output. 

20 2. Macros. Macros associate a name with a set of values. They enable string substitution 
within templates. 

3. Directives. Directives are commands that control code generation. 

25 4. Comments. Comments help to clarify the template and do not get emitted into the output 
file. 
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Throughout this Appendix there are references to the and 7 character. Th se characters 
mphasiz that the paramet r within these characters ar optional. For example consider 
the following: 
transform = toupper [index] 
5 wherein the 'index' parameter is optional. 

Template Files 

Template files are flat text files that are portable across different platforms. They can be 
edited with any text editor. White space is treated as-is and new line characters are 
1 0 expected at the end of each line. In the preferred embodiment, the template files conform 
to the XML specifications on each platfomi. 

Macros 

Macros enable string substitution within templates. 

15 

Macros Syntax 
$macro_name$ 

Description 

20 $macro_name$ defines a macro name that will be substituted with its assigned string 
value. The macro instance is replaced with the macro value as the output is emitted. A 
macro name consists of lower and upper case letters, and digits. 

A macro is an implicit array: a simple macro has either one string value, or a (ordered) 
25 sequence of string values; a macro structure is either a structure of macro fields (which, 
in turn, are implicit arrays) or it is an array of identical structures. Here identical structures 
is meant to imply that all the fields of the structures have the same names. 
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Example 1 (simple macro) 

Consid rth following t mplate definition: 

class $CLASS_NAME$ 
5 { 

}; 



If the user defines the macro CLASS_NAME to be GuiObject, then the following will be 
10 emitted: 

class GuiObject 
{ 

}; 

15 
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Macr Transformations 

Macro transformations allow you to take a macro value, convert It to some other form, and 
then use the result of th transfonnation as the macro value. A transformation can be used 
whenever a macro is used. 

5 

Syntax 

$macro_name| transforms 

The first transformation type ( | ) does not permanently change the value of the macro, but 
only during that particular macro emit. The second transformation type (=) permanently 
1 0 changes the value of the macro. 

The mechanism recognizes the following transformations: (note: [parameter] means 
optional parameter and the user must provide an index when using "[ ]") 

1 5 transform = toupper [i] | 

tolower [i] | 

truncate [maxlen] | 

separate separator | 

strip [pattern] | 
20 stripTrailing [pattern] | 

stripLeading [pattern] | 

change in_pattern outjDattem | 

increment [i] | 

numWords | 
25 words [i] | 

word[i] 

Description 

The following describes each transform: 

30 
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toupper - converts th macro value to all upper case I tt rs. If th optional 
paramet r i is specified, then only the i'th character is converted to upper case. 

tolower - converts the macro value to all lower case letters. If the optional parameter 
5 i is specified, then only the i'th character is converted to upper case. 

truncate - truncates the macro value to maxlen characters long by removing vowels. 
With no parameter, the default is to truncate to 8 characters. 

10 separate - separates the values in a muitivalue macro by a separator. If the 

separator is a string/character, it must be enclosed by quotes Othenwise it is 
assumed to be a macro name and the value of that macro is used as a separator. 
When used in a <repeat> statement, repeat blocks are separated by a separator. 

1 5 strip - removes all leading and trailing white space characters from the macro value. 

If a string pattern is specified (either as a string or a macro name), the pattern will 
be stripped off from the macro value. 

strlpTrailing - removes all trailing white space characters from the macro value. An 
20 optional pattern to strip can be specified 

stripLeading - removes all leading white space characters from the macro value. An 
optional pattern to strip can be specified. 

25 change in jaattern out_pattern - replaces every occurrence of the injattern in the 

macro value with the out^pattern. Again, strings/characters must be enclosed by 
quotes, else the parameter is assumed to be a macro name and the value of that 
macro will be used. 

30 increment - increments the value of the macro by one. If the optional parameter 1 is 
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specified, then the increment st p is i. 

numWords - returns the number of words of a string. If the string contains "This is 
an apple pie", numWords returns 5. 

5 

words[l] - returns the string after the ith word inclusively. In the previous example, 
words [3] would return "an apple pie". 

word[i] - returns the ith word in a string. In the previous example, word[3] would 
10 return "an". 

Example 1 : 

Consider the following template definition: 

1 5 #define _$CLASS_NAME|toupper$_HPP_ 
/* 

* File name: $CLASS_NAME|truncate$ 
*/ 

20 If the user defines the macro CLASS_NAME to be GuiObject, then the following will be 
emitted: 

#define _GUIOBJECT_HPP_ 

r 

25 * File name: GiObject 
V 

Example 2: 

Consider the following template: 
30 < TDEBIock > 
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<define MACRO=TILE_NAME">myFile.hpp</define> 
<define MACRO="EXTENSION">hpp</define> 
$FILE_NAME| change EXTENSION "cpp"$ 
</_TDEBIock_> 

5 

The above template file defines a macro called FILE^NAME whose string value is 
myPile.hpp and EXTENSION is a macro whose string value is hpp. For information 
regarding the define directive, refer below. The resulting output is emitted: 

10 myFile.cpp 

Example 3: 

Consider the following template: 
<_TDEBIock_> 
1 5 <define MACRO='firstname">John</define> 
<define MACRO="lastname">Doe</define> 
$firstname= toupper$ $lastname= toupper$ 
$firstname$ $lastname$ 
</_TDEBIock_> 

20 

In this case, the transfomiation type is used instead of the "1" transformation type. Note 
that this template file defines a firstname and lastname macro. The values of the firstname 
and the lastname macros are uppercased. Once this is done the values of the firstname 
and lastname macros are always uppercased. For information regarding the define 
25 directive, refer below. The resulting output is emitted: 

JOHN DOE 
JOHN DOE 



30 Note that the values of firstname and lastname macros retain their transformation (ie the 
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value of each macro is uppercased). 
Directives 

Directives define the flow of control in the template files. Directives are enclosed within "< 
5 >" delimiters (e.g. <name>) and can appear anywhere in the template. XML imposes some 
restrictions on attribute values. For example to form a well-formed XML document the 
characters *<' and may only be used to start tags and entities. Therefore, entity 
references must be used to represent the '<' and '&* characters. The following is list of 
entity references: 

10 

Entity Reference Character Representation 
& & 
< < 
> > 
15 &apos; 

&qout; 

Certain directives must be used in begin/end pairs using the notation <name> ... </name>. 

20 A directive with nothing inside is an empty directive and has no effect in the emitted text. 
If a directive starts in the middle of a line, the leading white space is taken as indentation 
for the language and it will not be emitted. 

The following directives are supported: 
25 _TDEBIock_ 
define 
clear 
if 

repeat 
30 scope 
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repeatscope 

includ 

outfile 

code 
5 call 

sameline 

assert 

hasscope 

ifhasscope 
10 ifhasrepeatscope 

targetscope 

repeattargetscope 

ifhasrepeattargetscope 

addtargetscope 
1 5 removetargetscope 

updatetargetscope 

updatetargetdoctype 

addattribute 

updateattribute 
20 removeattribute 

addtext 

updatetext 

removetext 

hastargetscope 
25 ifhastargetscope 

createalias 

_TDEBIock_ Directive 

30 _TDEBIock_ is the only required directive that should be the root element for each 
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template file. 
Syntax 

<_TDEBIock_SourceDOMTree="sourcedoc.xmrTargetDOMTree='1argetdoc.xml"^ 
5 section 

</_TDEBIock_> 

Description 

A source and target XML document can be specified in this directive. By specif/ing a 
1 0 target XML document one can write directives to modify the targeted XML document. By 
specifying a source XML document one can read data from the XML document. For more 
information see the "Modifying Existing DOM Trees" section. 

Example 1 : Simple template file 
15 <_TDEBIock_> 
</.TDEBIock_> 

Example 2: Simple template file that specifies a target XML document 
<_TDEBIock_TargetDOMTree="doc.xml"> 
20 </_TDEBIock_> 

Example 3: Simple template file that specifies a target XML document and a source XML 
document. 

<_TDEBIock_SourceDOMTree="sourcedoc.xml" TargetDOMTree="doc.xmr'> 
25 </_TDEBIock_> 

define Directive 

The define directive associates the specified value. macro_value, with the macro_name. 
30 NOTE: <define> can only be used to define simple macros. \ 
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Syntax 

<define MACRO="macro_nam [| transfomiation]">value</define> 
Description 

5 The define directive takes a single macro.value and assigns it to macro_name. The 
macro_value will be interpreted as is. If a transformation is present, macro_value Is 
transformed before being assigned to macro.name. Multiple values can be assigned to 
macro_name by performing subsequent definitions. For macros that have multiple value 
assignments, the values are concatenated together (without separators) and treated as a 
10 single string. See below for multi-valued macros usage in a repeat directive. The macro 
definition can be removed by the clear directive. 

NOTE: 

<define MACRO="IVlACRO">value</deflne> 
15 is different from 

<define MACRO="MACRO"> 

value 

</define> 

as an extra newline character is added by the later. 

20 

Example 1 : Single-value macro 
Consider the following template definition: 
<_TDEBIock_> 
<define MACRO="String"> 
25 Hi there. \ 

How are you? 
</define> 
$String$ 
</_TDEBIock_> 

30 
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The resulting output emitted Is: 
Hi there. How ar you? 

5 The backslash at the end of the first line prevents the end of line character from being 
embedded in the string. If *V is omitted, the text will be emitted on two lines as is. 

Example 2: Multi-value macro 

Consider the following template definition: 
10 <_TDEBIock_> 

<define MACRO='T_Class">Parent_</define> 

<define MACR0='T_Class">Clas8</define> 

<define MACRO="M_Class">my_class</define> 

class $M_Class$ : public $T_Class$ 
15 { 

ARG 

}; 

</_TDEBIock_> 
20 When you run the TDE, the following Is emitted: 
class my_class : public Parent_Class 

{ 

ARG 

25 }; 

Example 3: Transformation applied to macros 
Consider the following template definition: 
<?xml version="'1 .0"?> 
30 <!DOCTYPE _TDEBIock_ SYSTEM "../../../tde.dtd"> 
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<_TDEBIock_> 

<outfil FILENAME="define.log"> 
<define MACRO="macro1|toupper| strip E">one</clefin > 
<define MACRO="macro2|tolower|strip E">one</define> 
5 <define MACRO="macro3|tolowerlstrip e'*>ONE</define> 

$macro1$ 
$nnacro2$ 
$macro3$ 
</outfile> 
10 <„TDEBIock_> 

The following is emitted to the "define.log" file: 

ON 

15 one 
on 

The above template file defines a macro called "macrol " that goes through two transforms. 
The first transform uppercases the value of this macro, in this case the value changes from 

20 "one" to "ONE". After that transformation, the "E" is stripped from the end. The resulting 
macro is "ON". The second macro also goes through two transforms. The first transform 
lowercases the macro value from "one" to "one". In this case though this transform is 
meaningless since the macro value is already lower. After the tolower transform, an "E" 
character is stripped from the end. Note that this transform will fail since the "strip" 

25 transfonn is looking for a capital "E" character and the value of the macro is all lowercased. 
Therefore, the resulting macro value is "one". The last macro - macro3 - also goes through 
two transforms. The first transform lowercases the maao value from "ONE" to "one". The 
second transform strips the "e" character from the macro value. Note that at this point the 
macro value is all lowercased, therefore the resulting macro value will be "on". 

30 
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clear Directive 

The clear directive is used to cl ar th value for the macro associated with the 
macro_name supplied. 

5 Syntax 

<clear MACRO="macro-list"> 
where, 

macro-list = macro_name [, macro-list ] 
10 Description 

This directive is useful for changing the value of a macro_name. rather than adding to It 
(as the define directive does). Using a macro_name that has been previously cleared has 
the same effect as using a macro_name that has never been defined. Furthemiore. 
issuing a clear on a macro which has not been defined has no effect. 

15 

Example 

The following clears the macro MEMBER_NAME. 
<_TDEBIock_> 

<define MACRO="I^EMBER_NAME">foo</define> 
20 <clear MACRO="MEMBER_NAME"> 
$MEMBER_NAME$ 
</_TDEBIock_> 

The resulting emitted output is as follows: 
25 $MEMBER_NAME$ 

The macro MEMBER.NAME has a value of "foo" then it is cleared. When the macro is 
cleared it is as though the macro was never defined. Therefore the generated output 
would print out the macro name instead of the value (i.e. $MEMBER_NAME$). 

30 
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if Directive 

The if directive facilitates the emission of a s ction of code based on som condition(s). 
The syntax used for filtering is similar to that used for conditional branches in C. 

5 Syntax 

<if EXPRESSION="expr''> 

<else/> 

</if> 

where, 

1 0 expr= (expr logical-operator expr) 

(value cond value) 
($macro_name$) 
(lexpr) 

(!$macro_name$) 
1 5 logical-operator = & 1 1 

cond = == I != I < I > I <= I >= 
value = string | $macro_name$ 

Description 

20 The conditional expression must be fully parenthesized. An expression takes the fomn of 
a value, followed by a condition, then followed by a value. The value can be a string or 
another macro_name. The expression evaluates to a string comparison. The else clause 
is optional. If the expression is too long, you can use the 'T as an escape character to 
specify it on multiple lines. The I is used as a negation operator. If strings contain blanks 

25 they can be enclosed by quotes. The and operators are used for string containment: 
A < B evaluates to true if A is a substring of B (e.g. S1 < S2 evaluates if S1 is a substring 
of S2. ) On the other hand. *<=' and have a different interpretation compared to and 
*>'. and •>=' are relational operators used for comparing expressions, (e.g (value <=1 ) 
evaluates if value is smaller or equal to 1.) 
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Example #1 

This example illustrates the use of nested 
<_TDEBIock_> 

<lf EXPRESSION="($METHOD_NAME$ &qout;queue&qout;)"> 
5 code to emit if method name is "queue" 

<else/><if EXPRESSION="($METHOD_NAME$ &qout;print&qout;)"> 

code to emit if method name is "print" 
<else/> 

code to emit otheoA/ise... 
10 </if></if> 

</_TDEBIock_> 

Example #2 

This example illustrates the use of the less-than (<) operation and the and (&) operation. 
15 The conditional operators act on string values. 

<_TDEBIock_> 

<outfile FILENAME="if.log"> 

<define MACRO='TotalMethods"> print delete add </define> 
20 <define MACRO="MY_METHOD">print</define> 
<define MACRO="DONE">no</define> 

<if EXPRESSION="( (!($MY_METHOD$ < $TotalMethods$)) & ( $DONE$ 1= 
&qout;yes&qout;))"> 

code to emit if we're not done and my method is unknown 
25 </if> 

</outfile> 

</ TDEBIock > 
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The emitted code is as follows: 

code to emit if we're not done and my m thod is unknown 

Since the MY_METHOD macro is a substring of TotalMethods and the DONE macro is not 
5 equal to "yes" the section of text within the if statement is emitted. 

Example #3 

This example illustrates the use of a single macro_name: 
<_TDEBIock_> 
1 0 <if EXPRESSION="($MEMBER$)"> 
code to emit if member has a value 
</if> 

</_TDEBIock_> 

No code is emitted since the MEMBER macro is not defined. 

15 

repeat Directive 

The repeat directive allows a single section of a template to emit over and over again on 
multivalue macro. It acts as a macro iterator. 

20 Syntax 

<repeat MACRO="macro-list [| transfonnation]"> 

section 

</repeat> 

where 

25 macro-list = macro_name [, macro-list] 

Description 

The repeat directive will emit a section, within the start and end delimiters, repeatedly for 
each value associated with macro_name. The macro-list defines which macros to iterate 
30 over. If a macro has multiple values, each value will be emitted once in the repeat section. 
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In essence, the repeat is analogous to a for loop, looping through all the macro values. If 
a transformation Is present, it appli s to the text contained within the repeat section. The 
number of Iterations is the smallest number of values the macros hav . If one of the 
macros is undefined, the code inside the <repeat> ... </repeat> will not be emitted. 

5 

Example 1 

Consider the following template definition: 
<_TDEBIock_> 

<define MACR0="C0UNr'>1</define> 
10 <define MACR0="C0UNT'>2</define> 

<define MACR0="C0UNT'>3</define> 
<repeat MACRO="COUNr'> 
list.add(person$COUNT$); 
</repeat> 
15 </_TDEBIock_> 

When the template is parsed, the following is emitted: 
list.add(person1}; 
list.add(person2); 
20 list.add(person3); 

Example 2 

Consider the following template definition: 
<_TDEBIock_> 
25 <define MACRO="TYPE">int</define> 

<define MACRO='TYPE">char</define> 
<define MACRO="FUNC">print</define> 
<defineMACRO="FUNC">display</define> 
<repeat MACRO='TYPE,FUNC"> 
30 void $FUNC$ ($TYPE$ x); 
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</repeat> 
</_TDEBIock_> 

When the template is parsed, the following is emitted: 
5 void print (int x); 

void display (char x); 

Example 3 

Consider the following template definition 
10 <_TDEBIock_> 

<define MACRO='TyPE">int</define> 
<define MACRO="7YPE">char</define> 
<define MACRO="PARAM">i</define> 
<define MACRO="PARAI\/l">c</define> 
15 void func( 

<repeat MACRO='TYPE,PARAM | separate > 

$TYPE$ $PARAM$ 
</repeat> 

); 

20 </_TDEBIock_> 

When the template is parsed, the following is emitted: 

vokJ func( 
25 int i, 

chare 

): 

scope Directive 

30 The scope directive is used to navigate the XML model and specify how the macros in a 
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section are scoped. 
Syntax 

<scope NAME="sname"> 
5 section 
</scope> 

Description 

The sname specifies the name of the scope. 

10 

Example 

Suppose the model defines an element "Class" which has two other embedded elements. 

<Class name="Set"> 
15 <Method name="add"> 
</Method> 
</Class> 

When the element "Class" is generated, using the following template: 

20 

<_TDEBIock_> 

class $name$ { this $name$ is from the Class object 

<scope NAME="Method"> 
void $name$<); 
25 </scope> 

}; 

</_TDEBIock_> 

this will be emitted as: 

30 
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class Set { 

void add(); 

} 

5 In order to make scoping conceptually easy to use, a 'directory' navigation approach has 
been adopted. By specifying a IP an implicit scope operation is implied. For example, 
consider the following XML document. 

<classlist> 

1 0 <class classname="MyClass"> 

<datamember>Member1 </datamember> 
</class> 
</classlist> 

1 5 And the following template file: 

<_TDEBIock_> 
<scope NAME="class"> 
<scope NAME="datamember"> 
20 </scope> 
</scope> 
</_TDEBIock_> 

The above template file can also be written as: 

25 

<_TDEBIock_> 

<scope NAME="class//datamember"> 

</scope> 

</_TDEBIock_> 

30 
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It is also possible to write a template without using the scope directive. Consider the 
following XML document. 

<Class name="Set"> 
5 <Method name="add"> 
</Method> 
</Class> 

Also consider the following template file. 

10 

<_TDEBIock_> 

class $name$ { <- this $name$ is from the Class object 
void $Method//name$(); 

}; 

15 </_TDEBIock_> 

The following is the resulting emitted code: 
class Set { 

void add(); 

20 } 

The scoping navigation starts at the current scope. However, navigation can occur relative 
to the root element by specifying a IP in front of the scoping pattern. Parent navigation can 
also be achieved by specifying within the scoping pattern. Consider the following XML 
25 document. 

<classlist> 
<class classname="MyClass"> 
<datamember>Member1 </datamember> 
30 </class> 
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</classlist> 

And, the following template file. 

5 <_TDEBIock_> 

<scope NAME="class"> 

<scope NAME="datamember''> 
<scope NAME=".."> 
$classname$ 
10 </scope> 
</scope> 
</scope> 
</.TDEBIock_> 

15 The following would be emitted: 
MyClass 

An XML document can consists of elements of the same type. In order to navigate 
elements of the same type an index is specified to represent a specific element. For 
20 example the following XML document consists of three elements of the same type. 

<classlist> 
<class> 

<method>init</method> 
25 <method>read</method> 
<method>write</method> 
</class> 
</classlist> 



30 



Scoping can occur based on the position of the element. 
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template file. 

<_TDEBIock_> 
<scope NAME="class"> 
5 <scopeNAME="method[1]"> 
$TEXT$ 
</scope> 

<scope NAME="method[2]"> 
$TEXT$ 
10 </scope> 

<scope NAME="method[0]"> 

$TEXT$ 
</scope> 
</scope> 
15 </_TDEBIock_> 

The following would be emitted: 

read 

20 write 
init 

repeatscope Directive 

The repeatscope directive allows a single section of a template to emit over and over again 
25 on a list of elements. It acts as an element iterator. 

Syntax 

<repeatscope NAME="sname" SEPARATOR="separator'*> 
section 
30 </repeatscope> 
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Description 

The sname specifies the name of the scope. The separator specifies the delimiter to use 
between sections. The default value is an empty string. 



Suppose the model defines an element "Class" which has two other embedded elements. 

<Clas8list> 
<Class name="Set"> 
10 <Method name="add"> 
</Method> 

<Method name="del"> 



5 



Example 1 



</Method> 



</Class> 



15 



</Classlist> 



When the element "Class" is generated, using the following template: 



< TDEBIock > 



20 



<scope NAME="Class"> 
<repeatscope NAME="Method"> 



$name$ 
</repeatscope> 



</scope> 



25 



</ TDEBIock > 



The following would be emitted, 
add 



del 



30 
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ExampI 2 

Consider the following XML document. This example shows how one can use the 
•SEPARATOR* attribute. 

5 <Elementlist> 

<Element name="A"/> 
<Element name- 'B7> 
<Element name="C'7> 
<Element name="D"/> 
1 0 <Element name="E'7> 
<Element name="F7> 
<Element name="G'7> 
</Elementlist> 

1 5 And, the following template file. 
<_TDEBIock_> 

<repeatscope NAME="Element" SEPARATOR="."> 
$name$ 
</repeatscope> 
20 </_TDEBIock_> 

The resulting emitted code is as follows: 
A,B.C,D,E.F,G 

25 include directive 

The include directive imbeds a single input template file in-line. 

Syntax 

<include FILENAME="input_file_name"/> 

30 
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Description 

The include directive includes an entire file specified by input_file_name, into the input 
stream for processing. It is analogous to the #include file_name C directive. The 
input_file_name must be an input template file. 

5 

Example 

A file called commenttde contains the following: 

1 0 // C++ Generated Code 

// 

Consider the following template file which includes commenttde: 

15 <_TDEBIock_> 

<include FILENAME="comment.tde7> 

class A 0; 
</_TDEBIock_> 

20 The following Is emitted: 

//. 

// C++ Generated Code 

//. 

25 class A 0; 

outfile Directive 

The outfile directive specifies the output file to write to for that section of the template. 
30 Syntax 
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<outfile FILENAME="outfile_name" MODE="_modeJ'> 

s ction 

</outfile> 

where, 

5 outfile_name = $macro_name$ | string 

_mode_ = append | new 

Description 

When the outfile directive is encountered, the specified outfile_name is opened with the 
1 0 specified mode, and the section of the template is written to that output file. 

Example 

Consider the following template definition: 

15 <_TDEBIock_> 

<outfile FILENAME="$filename$" MODE="new"> 

// C++ generated code 

foo(); 

<outfile FILENAME="d:\\log.daf MODE="append"> <- need to escape the backslash 
20 This is a log entry. 
</outfile> 

// End C++ generated code 

</outfile> 

</_TDEBIock_> 

25 

If the macro filename is defined to be foo.cpp. the following is emitted to foo.cpp: 

// C++ generated code 
fooO; 

30 // End C++ generated code 
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The file d:\log.dat will contain the following: 

This is a log entry. 

5 code Directive 

The code directive identifies a section of code to emit when the cname value is set. 

Syntax 

<code NAME="cnanne"> 
10 section 
</code> 

A code section can also be declared with parameters, in which case the call directive must 
be used to emit it. 

15 

<code NAME - 'cname, paraml. param2. param_n"> 

section 

</code> 

20 Description 

The code directive takes a single cname and emits the delimited section if cname is 
invoked. If cname is not set, the section is not emitted. Code sections are useful for 
reusing templates, or for oven^iding other code sections with the same name. When using 
the <scope> directive, code sections can also be invoked recursively. The tenninating 
25 condition is implicitly defined by the model, that is, when the code section is invoked from 
within a <scope> section that will eventually not be reached. 

Examplel 

Consider the following template: 

30 
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<_TDEBIock_> 

<code NAME ="C_FORM"> 

malloc(sizeof(Fred)); 

</code> 

5 <code NAME ="CPP_FORM"> 

Fred* pTemp = new Fred; 
</code> 

<call NAME ="CPP_F0RM7> 
return ok; 
10 </_TDEBIock_> 

The following is emitted: 

Fred* pTemp = new Fred; 
15 return ok; 

call directive 

The call directive is the only way of invoking code sections. (Recall that a code section can 
also be emitted as a macro, by enclosing its name with $. This only works for code sections 
20 with no parameters). 

Syntax: 

<call NAME="codeName" MACROLIST="macro1 macro2 ... macro_n7> 
Ail the arguments of the call directive (a code name followed by macro names) can be 
25 separated by commas. 

Example: 
<_TDEBIock_> 
<code NAME="C. M, N"> 
30 M = $M$ 
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<repeat MACRO="N"> 

N = $N$ 
</rep8at> 
</code> 

5 <call NAME="C" MACROLIST="M, N7> 
</_TDEBIock_> 

If macro M was defined to have value "foo" and N to have two values, "bar" and "BAR" 
then the following is emitted: 

10 

M = foo 
N = bar 
N = BAR 

15 sameline Directive 

Syntax 
<sameline> 
section 
20 </sameline> 

Description 

The sameline directive is used to put its contained section on a single output line. Basically, 
all the newline characters from the section are removed and what follows after </sameline> 
25 will start on a new line. 

Example 1 

Consider the following template: 

30 <_TDEBIock_> 
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<sameline> 
int func( 

<repeat MACRO=TARMS | separate ",""> 
$PARMS$ 
5 </repeat> 

); 

</sameline> 
</_TDEBIock_> 

10 When the template is parsed with PARMS containing values "int a" and "char c", the 
following is emitted: 

int func(int a, char c); 

15 assert Directive 

Syntax 

<assert EXPRESSION="expr"/> 
expr= (expr logical-operator expr) 
20 (value cond value) 

($macro_name$) 

(lexpr) 

(l$macro_name$) 
logical-operator = & 1 1 
25 cond = == 1 1= I < I > I <= I >= 

value = string 

Description 

The assertion directive is used to test a boolean expression. If this expression is evaluated 
30 to false, an assertion failure exception is thrown. 
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Examplel 

Consid r the following template: 

<_TDEBIock_> 
5 <deflne MACRO="macroA">Bird</define> 

<define MACRO="macroB">Bee</define> 
<sameline> 
int func( 

<assert EXPRESSION="$macroA$ < $macroB$7> 
10 ); 

</sameline> 
</_TDEBIock_> 

When the template is parsed nothing is emitted since Bird is not a substring of Bee. 
15 Instead an assertion failure exception is thrown. 

hasscope directive 

The hasscope directive is used to determine if a scope exists within the XML model. 

20 Syntax 

<hasscope NAME="sname"> 

section 

</hasscope> 

25 Description 

The sname specifies the name of the scope. This directive does not navigate the XML 
model. If the scope name does exist the 'section' is emitted. 

Example 

30 Suppose the model defines an element "Class" which has two other embedded elements: 
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<Class name="Set"> 
<M thod name="add"> 
</Method> 

<Method name="del"> 
5 </Method> 
</Class> 

When the part "Class" is generated, using the following template: 

10 <_TDEBIock_> 

class $name$ { <- this $name$ Is from the Class object 

<hasscope NAME="Method"> 

rstarting Method Declaration*/ 

<scope NAME="Method"> 
15 void $name$(); 

</scope> 

/*End of Method Declaration*/ 

</hasscope> 

}: 

20 </_TDEBIock_> 

The following is emitted: 
class Set { 

25 /*Startjng Method Declaration*/ 

void add(); 
void del(); 

/*End of Method Declaration*/ 

} 

30 



CA9-1 999-0037 



61 



CA 02311870 2000-06-15 



ifhasscop directive 

The ifhasscope directive b haves in the same manner as a hasscope directive followed 
by a scope directive. This directive first tests whether the scop name exists. If the scope 
name does exist the scope name is navigated. This directive may be used in conjunction 
5 with an else statement. 

Syntax 

<ifhasscope NAME="sname"> 
sectionA 
10 <else/> 
sectionB 
</ifhasscope> 

Description 

1 5 The sname specifies the name of the scope 
Example 

Suppose the model defines an element "Class" which has two other embedded elements: 

20 <Class name="Set"> 

<Method name="add"> 
</Method> 

<Method name="der'> 
</Method> 
25 </Class> 

When the part "Class'* is generated, using the following template: 

<_TDEBIock> 
30 class $name$ { 
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<ifhasscope NAME="Method"> 
/*Starting Method D claration*/ 

void $name$(); 
/*End of Method Declaration*/ 
5 <else/> 

method was not there 
</ifhasscope> 

}; 

</_TDEBIock_> 

10 

The following is emitted: 

class Set { 

rstarting Method Declaration*/ 
15 void add(); 

/*End of Method Declaration*/ 

} 

Note only the first method is emitted. In order to emit the second method a second 
20 "ifhasscope" directive must be added to the template file. If it were not possible to scope 
to method, the else statement would have been executed. 

ifhasrepeatscope directive 

The ifhasrepeatscope directive behaves in the same manner as a hasscope directive 
25 followed by a repeatscope directive.This directive first tests whether the scope name exist. 
If the scope name does exist all children elements that matches the scope name are 
navigated. This directive works in conjunction with the else statement. 

Syntax 

30 <ifhasrepeatscope NAME="sname"> 
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sectionA 

<else/> 

sections 

</ifhasrepeatscope> 

5 

Description 

The sname specifies the name of the scope 
Example 

10 Suppose the model defines an element "Class" which has two other embedded elements: 

<Class name="Set"> 

<Method name="add"> 

</Method> 
15 <Method name="der> 

</Method> 
</Class> 

When the part "Class" is generated, using the following template: 

20 

<_TDEBIock> 
class $name$ { 

<ifhasrepeatscope NAME="Method"> 
^Starting Method Declaration*/ 
25 void $name$(); 

/*End of Method Declaration*/ 
<else/> 
no methods were found 
</ifhasrepeatscope> 
30 }; 
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</_TDEBIock_> 

The following is emitted: 

5 class Set { 

^Starting Method Declaration*/ 
void add(); 
void delQ; 

/*End of Method Declaration*/ 

10 } 

Note that in this example the second method is emitted. The ifhasrepeatscope navigates 
to all elements that matches the scope name. In this case the scope name is "Method". 
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Modifying Existing DOM Trees 

T mplate files can be created to modify existing DOM trees associated with a domain 
mod I. There are several main operations that are defined to accomplish this task. Add 
an element, remove an element, scope to an element, update an attribute, update an 
5 element, add an attribute and remove an attribute. 

targetscope directive 

The targetscope directive navigates an element that is part of an existing DOM tree 
associated with a domain model. 

10 

Syntax 

<targetscope NAME="sname" INDEX=Jndex_> 
section 

</targetscope> 
15 where, 

sname = target scope name 
Jndex_ = integer value 
Description 

The sname specifies the name of the scope. The Jndex_ value specifies which element 
20 to navigate based on an index value. The default value is set to 0. Therefore, if there is 
more than one element that is found, the first element is scoped. 

Example 

Suppose the model defines an element "Class" which has two other embedded elements. 
25 This document is called class.xml. 

<Classlist> 
<Class name="Set"> 
<Method name="add"> 
30 </Method> 
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<Method name="der'> 
</M thod> 
</Class> 
</Classlist> 

5 

Also consider the following template: 
<?xml version="1.0"?> 

<!DOCTYPE „TDEBIock_ SYSTEM "dtd/tde.dtd"> 
1 0 <_TDEBIock_ DOMTree="class.xml"> 

<targetscope NAME="Class"> 

</targetscope> 
</_TDEBIock_> 

15 The mechanism will navigate to the Class element in the class.xml document. Note no 
emitted output is created since this directive just navigates the targeted XML document. 
In this case the targeted XML document is class.xml. 

addtargetscope directive 
20 The addtargetscope directive is used to insert an element into a OOM tree associated with 
a domain model. 

Syntax 

<addtargetscope NAME="sname" INDEX=Jndex_> 
25 where, 

sname = target scope name 
Jndex_ = integer value 

Description 

30 The sname specifies the name of the scope. The Jndex_ value specifies where to insert 
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the element. The d fault value of the index is set to 0. Therefore, the elem nt that Is 
added will become the first child el ment. If a -1 is specified as th Index the element that 
is added will be the last child element. 

5 Example 

Suppose the model defines an element "Class" which has two other embedded elements. 
Lets say that this document is called class.xml. 

<Classlist> 
10 <Class name="Set"> 
<Method name="add"> 
</Method> 

<Method name="der> 
</Method> 
15 </Class> 

</Classlist> 

Also consider the following template: 

20 <?xml version="1.0"?> 

<!DOCTYPE _TDEBIock_ SYSTEM "dtdAde.dtd"> 
<_TDEBIock_ DOMTree="class.xml"> 
<targetscope NAME="Class"> 
<addtargetscope NAME="Method"> 
25 <addtargetscope NAME="Argument"></addtargetecope> 

</addtargetscope> 
</targetscope> 
<l TDEBIock > 



30 



The result of applying the template is as follows: 
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<ClassList> 
<Class name="Set'> 
<M thod> 
<Argument/> 
5 </Method> 

<Method name="add"> 
</Method> 

<Method name="del"> 
</Method> 
10 </Class> 

</Classlist> 

updatetargetscope directive 

The updatetargetscope directive is used to update an element of a DOM tree associated 
1 5 with a domain model. If the element does not exist it is Inserted into the DOM tree. 

Syntax 

<updatetargetscope NAME="sname" INDEX=Jndex_> 
where, 

20 sname = target scope name 

Jndex_ = integer value 

Description 

The sname specifies the name of the scope. The default value of the index is set to 0. 
25 Therefore, the first element will be updated. The index value is only used when adding an 
element. 

Example: Simple target document update 

Suppose the model defines an element "Class" which has two other embedded elements. 
30 This document is called class.xml. 
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<Class name="Sef'> 
<Methocl name="add"> 
</Method> 

<Methocl name="der'> 
5 </Method> 
</Class> 

Also consider the following template: 

1 0 <?xml version="1 .0"?> 

<IDOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_ DOMTree="class.xml"> 
<define MACRO=newMethodName>addNew</define> 
<targetscope NAME="Method"> 
1 5 <updatetargetscope NAME="name" 

TYPE="ATTRIBUTE>$newl\/letliodName$</addtargetscope> 
</targetscope> 

</_TDEBIock_> 

20 

the result of applying the template is as follows: 

<Class name="Set"> 
<Method name="addNew"> 
25 </Method> 

<Method name="del"> 

</Method> 

</Class> 

30 Notice the name of the first method changes from "add" to "addNew". 
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removetargetscope directive 

The removetargetscope directive is used to delete an element from a DOM tree associated 
with a domain model. 

5 Syntax 

<removetargetscope lSlAME="sname" INDEX=JndexJ> 
where, 

sname = target scope name 
Jndex_ = integer value 

10 

Description 

The sname specifies the name of the scope. The Jndex_ value specifies which element 
to remove based on an index value. The default value is set to 0. Therefore, if there is 
more than one element, the first element is removed. If the index is set to -1 the last child 
1 5 element is removed. 

Example 

Suppose the model defines an element "Class" which has two other embedded elements. 
Lets say that this document is called class.xml 

20 

<Class name="Set"> 
<Method name="add"> 
</Method> 

<Method name="del"> 
25 </Method> 
</Class> 



Also consider the following template: 

30 <?xml version="1 .0"?> 
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<!DOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_DOMTree="class.xmr'> 

<removetargetscope NAME="Method7> 
</_TDEBIock_> 

5 

the result of applying the template is as follows: 

<Class name="Set"> 
<Method name="del"> 
10 </IVIethod> 
</Ciass> 

Note that the first method element was removed. Since no index was specified the default 
value for the index is 0. 

15 

updatetargetdoctype directive 

The updatetargetdoctype directive is used to update the IDOCTYPE element of a DOM 
tree associated with a domain model. If the element does not exist is it inserted into the 
DOM Tree. 

20 

Syntax 

<updatetargetdoctype SYSTEM_URL="SYSTEM_URL" PUBLIC_NAME="DTD_NAME" 

PUBLIC_URL="DTD_URL" ROOT_ELEMENT_NAME="root_element"> 

where, 

25 DTD_name ~ a name that identifies the dtd file 

DTD_URL = an absolute or relative uri where the dtd file can be found 
SYSTEM_URL = an absolute or relative urI where the dtd file can be found 
root_element = the root element tag name 

30 Description 
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The DTD_URL is an absolute or relative path where the dtd file can be found. The 
DTD_URL is used if one wants to sp cify a public dtd. This attribut should only be 
specified if a public dtd is being used. Similarly the SYSTEM_URL is also an absolut or 
relative path where the dtd file can be found. This should be specified If a system dtd is 
5 being used. The DTD_name is a identifier that identifies the dtd file and is used when 
specifing a public dtd file. The root_element is the name of the root element of the 
document. If the root_element is not specified the mechanism will search the target 
document and find the root element tag name. 

10 Examplel : Adding a simple IDOCTYPE element 
Consider the following template file: 

<?xml versions" 1.0"?> 

<IDOCTYPE _TDEBIock_ SYSTEM "../../../../dtd/tde.dtd"> 
15 <_TDEBIock_> 

<updatetargetdoctype PUBLIC_NAME="Chemistry" 
PUBLIC_URL="http://sunsite/unc.edu/public/chemistry.dtd" ROOT_ELEMENT_NAME="myroot"/> 
</_TDEBIock_> 

20 the result of applying the template is as follows: 

<?xml version="1 .0" standalone="no"?> 

<!DOCTYPE myroot PUBLIC "Chemistry" " httD://sunsite/unc.edu/Dublic/chemistry.dtd"> 

25 Example2: Adding a simple IDOCTYPE element plus an element. 
Consider the following template: 
<?xml verslon="1.0"?> 

<IDOCTYPE _TDEBIock_ SYSTEM "../.. /../../dtd/tde.dtd"> 
<_TDEBIock_> 

30 <updatetargetdoctype SYSTEM_URL="mydtd.dtd" 
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ROOT_ELEMENT_NAME="MyMember"/> 
<updat targetscope NAME- 'MyMember"> 

This is the text for th new member 
</updatetargetscope> 
5 </_.TDEBIock_> 

the result of applying the template is as follows: 

<?xml version="1.0" standalone="no"?> 
1 0 <IDOCTYPE MyMember SYSTEM "mydtd.dtd"> 
<MyMember/> 

Examples: Adding a simple IDOCTYPE element after adding an element 
Consider the following template: 
15 <?xml version="1.0"?> 

<IDOCTYPE _TDEBIock_ SYSTEM "../.,/../. ./dtd/tde.dtd"> 
<_TDEBIock_> 
<updatetargetscope NAME="MyMember"> 
This is the text for the new member 
20 </updatetargetscope> 

<updatetargetdoctype SYSTEM_URL="mydtd .dtd'V> 
</_TDEBIock_> 

the result of applying the template is as follows: 

26 

<?xml version=:"1.0" standalone="no"?> 
<IDOCTYPE MyMember SYSTEM "mydtd.dtd"> 
<MyMember> 

This is the text for the new member 
30 </MyMember> 
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Note that since the root node already exists (ie MyM mber is created) at th point where 
"updat targetdoctype" is d fined, the ROOT.ELEMENT attribute does not need to be 
specified. The mechanism will know that "MyMember" is the root element and fill in the 
appropriate information in the IDOCTYPE element. 

5 

addattribute directive 

The addattribute directive adds an attribute to an existing element. 
Syntax 

1 0 <addattribute NAME="attrname">attrbute value</addattribute> 
where, 

attrname = attribute name. 
Description 

15 The attrname specifies the name of the attribute. If the attribute already exits the attribute 
will not be added to the element. 

Example 

Suppose the model defines an element "Class" which has two other embedded elements. 
20 This document is called class.xml. 

<Class name="Set"> 
<Method name="add"> 
</Method> 
26 <Method name="der'> 
</Method> 
</Class> 

Also consider the following template: 

30 
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<?xml version="1 .0"?> 

<!DOCPrPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_ DOMTree="class.xml"> 
<targetscope NAME="Class"> 
5 <addtargetscope NAME="Method"> 

<addattribute NAME="name">newMethod</addattribute> 

</addtargetscope> 
<^argetscope> 
</_TDEBIock.> 

0 

the result of applying the template is as follows: 



<Class name="Set"> 
<Method name="newMethod"> 
15 </Method> 

<Method name="add"> 
</Method> 

<Method name="del"> 
</Method> 
20 </Class> 



updateattribute directive 

The updateattribute directive behaves in the same manner as the addattribute directive. 



25 Syntax 

<addattribute NAME="attrname">attrbute value</addattribute> 
where, 
attrname = attribute name. 

30 Description 
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The attrname specifies the name of the attribute. If the attribute already exists the attribute 
value will be updated with the value specified in this directive. 

Example 

5 Suppose the model defines an element "Class" which has two other embedded elements. 
This document is called class.xml. 

<Class name="Set"> 
<Method name="add"> 
10 </Method> 

<Method name="der'> 

</Method> 

</Class> 

1 5 Also consider the following template: 
<?xml version="1.0"?> 

<IDOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_ DOMTree="class.xml"> 
20 <targetscope NAME="CIass"> 

<addtargetscope NAME="Method"> 

<updateattribute NAME="name">newMethod</addattribute> 

</addtargetscope> 

<updateattribute NAME='*name">NewSetClass</addattribute> 
25 </targetscope> 
</ TDEBIock > 



30 



the result of applying the template is as follows: 

<Class name="NewSetClass"> 
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<Method name="newMethod"> 
</Method> 

<Method name="add"> 
</Method> 
5 <Method name="der'> 
</Method> 
</Class> 

Note the first updateattribute directive adds an attribute named "newMethod" on the newly 
10 created method element. The second updateattribute directive updates the "name" 
attribute on the Class element. 

removeattribute directive 

The removeattribute directive removes an attribute from an existing element. 

15 

Syntax 

<removeattribute NAME="attrname"/> 
where, 

attrname = target attribute name 

20 

Description 

The attrname specifies the name of the attribute. 
Example 

25 Suppose the model defines an element "Class" which has two other embedded elements. 
This document is called class.xml. 

<Class name="Set"> 
<Method name="add"> 
30 </Method> 
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<Method name="del"> 

</Method> 

</Class> 

5 Also consider the following template: 
<?xml versions" 1.0"?> 

<!DOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_ DOMTree="class.xmr> 
1 0 <targetscope NAME="Method"> 

<removeattribute NAME="name7> 
</targetscope> 
</„TDEBIock_> 

1 5 the result of applying the template is as follows: 

<Class name="Set"> 
<Method> 
</Method> 
20 <Method name="der'> 
</Method> 
</Class> 

Note the '*name" attribute on the first Method element was removed. 

25 

addtext directive 

The addtext directive adds text to an existing element. 
Syntax 

30 <addtext INDEX="JndexJ'>text content</addtext> 
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where. 
Jnclex_ = integer value 

Description 

5 The Jndex_ value specifies where to insert the text. The default value of the Index is set 
to 0. Therefore, the text content that is added will become the first child element. 

Example 

Suppose the model defines an element "Class" which has two other embedded elements. 
10 This document is called class.xml. 

<Class name="Set"> 
<Method name="add"> 
</Method> 
15 <Method name="der> 
</Method> 
</Class> 

Also consider the following template: 

20 

<?xml version="1.0'7> 

<!DOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_ DOMTree="class,xmr> 
<targetscope NAME="Class"> 
25 <addtext>This class is a collection of objects</addtext> 

</targetscope> 
</_TDEBIock_> 

the result of applying the template is as follows: 

30 
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<Classnam ="Set"> 
This class is a collection of objects 
<Method nam ="add"> 
</Method> 
5 <Method name="del"> 
</Method> 
</Class> 

updatetext directive 

10 The updatetext directive behaves in the same manner as the addtext directive. 
Syntax 

<updatetext INDEX="JndexJ'>text content</updatetext> 
where, 

15 Jndex_ = integer value 

Description 

The Jndex_ value specifies which text content to update. The default value of the index 
is set to 0. Therefore, the text content that is updated will become the first child element. 
20 If no text content is found at the specified index it is added at the index specified. 

Example 

Suppose the model defines an element "Class" which has two other embedded elements. 
This document is called class.xml. 

25 

<Class name="Sef> 
This is a collection of objects 
<Method name="add"> 
</Method> 
30 <Method name="del"> 



CA9-1 999-0037 



81 



CA 02311870 2000-06-15 



</Method> 
</Class> 

Also consider the following template: 

5 

<?xml version="1 .0"?> 

<IDOCTYPE .TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_ DOMTree="class.xmr'> 
<targetscope NAME="Class"> 
1 0 <targetscope NAME="Method"> 

<updatetext>//This method adds an object to the collection</updatetext> 

</targetscope> 

<updatetext>//This is a collection of objects. Also known as a set of objects. </updatetext> 
</targetscope> 
15 </_TDEBIock_> 

the result of applying the template is as follows: 

<Class name="NewSetClass"> 
20 //This is a collection of objects. Also known as a set of objects. 
<Method name="add"> 
//This method adds an object to the collection 
</Method> 

<Method name="der> 
25 </Method> 
</Class> 

Note the first updatetext directive adds text content to the first method element. The 
second updatetext directive updates text content associated with the Class element. 

30 
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removetext directive 

Th removet xt directiv removes t xt content from an existing element. 
Syntax 

5 <removetext INDEX=' JndexJ7> 
where, 
Jndex_ = integer value 

Description 

1 0 The Jndex_ value specifies which text content to remove. The default value of the index 
is set to 0. Therefore, the text content that is removed will be the first child element 

Example 

Suppose the model defines an element "Class" which has two other embedded elements. 
15 This document is called class.xmL 

<Class name="Set"> 

This is a collection of objects 

<Method name="add"> 

</Method> 
20 <Method name="der'> 

</Method> 

</Class> 

Also consider the following template: 

25 

<?xml version="1 .0"?> 

ODOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<„TDEBIock_ DOMTree="class.xmr'> 
<removetext/> 
30 </_TDEBIock_> 
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the result of applying the template is as follows: 

<Classnam ="Set"> 
<Method> 
5 </Method> 

<Method name="der'> 

</Method> 

</Class> 

10 Note the text content under the Class element was removed, 
hastargetscope directive 

The hastargetscope directive behave in a similar manner as the hasscope directive. 
However, this directive applies to the targeted DOM tree. If the targeted DOM tree 
15 contains the scope name the section of code defined within this directive is parsed. 

Syntax 

<hastargetscope NAME="sname" INDEX=Jndex_> 
section 

20 </hastargetscope> 
where, 

sname = target scope name 
Jndex_ = integer value 

25 Description 

The sname specifies the name of the scope. The Jndex_ value specifies if the element 
at the index value exists. The default value is set to 0. 

Example 

30 Suppose the model defines an element "Class" which has two other embedded elements. 
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This document is called class.xml. 
<Class name="Set"> 
<Metliod name="add"> 
</Method> 
6 <Method name="del"> 
</Method> 
</Class> 

Also consider the following template: 

10 

<?xml versions" 1.0"?> 

<!DOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_ DOMTree="class.xmr'> 
<targetscope NAME="Class"> 
1 5 <hastargetscope NAME="N0Element'7> 

<removetargetscope NAME="Method7> 

</hastargetscope> 
</targetscope> 
</_TDEBIock_> 

20 

this resulting DOM tree is as follows: 

<Class name="Set"> 
<Method name="add"> 
25 </Method> 

<Method name="del"> 

</Method> 

</Class> 



30 Note that no changes were made. Since the "NOEIement" was not found in the targeted 
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DOM tree everything within the hastargetscope does not get processed, 
repeattarg tscope directive 

The repeattargetscope directive behaves in a similar manner as the repeatscope directive. 
5 However, this directive applies to the targeted DOM tree. The repeattargetscope iterates 
over a list of child elements. 

Syntax 

<repeattargetscope NAME="sname"> 
10 section 

</repeattargetscope> 
where, 

sname = target scope name 

15 Description 

The sname specifies the name of the scope. 

Example 

Suppose the model defines an element "Class** which has two other embedded elements. 
20 This document is called class.xml. 
<Class name="Set"> 
<Method name="add"> 
</Method> 

<Method name="del"> 
25 </Method> 
</Class> 



Also consider the following template: 

30 <?xml version="1 .0"?> 
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<IDOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock„ DOMTree="class.xml"> 
<repeattargetscop NAME="Method"> 

<addattribute NAME="type">void</addattribute> 
5 </repeattargetscope> 
</_TDEBIock_> 

this resulting DOM tree is as follows: 

10 <Class name="Set"> 

<Method name="add" type="void"> 
</Method> 

<Method name="del" type=**void"> 
</Method> 
15 </Class> 

ifhasrepeattargetscope directive 

The Ifhasrepeattargetscope directive behaves in a similar manner as the ifhasrepeatscope 
directive. However, this directive applies to the targeted DOM tree. The 
20 ifhasrepeattargetscope directive iterates over a list of child elements. If a child list does 
not exist the section of text between the directive does not get processed. This directive 
may also be used with the else statement. 

Syntax 

25 <ifhasrepeattargetscope NAME="sname"> 
sectionA 
<else/> 
sections 

</ifhasrepeattargetscope> 
30 where, 
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sname = target scope name 
Description 

The sname specifies the name of the scope. 

5 

Example 

Suppose the model defines a list of elements. This document is called elementxml. 

<ElementList> 

<Element index="r7> 
10 <Element lndex="2"/> 

<Element index="3"/> 

<Element index="4"/> 

<Element index="5"/> 

<Element index="6'7> 
15 <Element index="77> 

<Element lndex="8'7> 

</ElementList> 

Also consider the following template: 

20 

<?xml versions" 1.0"?> 

<!DOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_DOMTree="element.xml"> 

<ifhasrepeattargetscope NAME="NOEIement"> 
25 <addattribute NAME="name">ElementName</addattribute> 

<else/> 

<addtargetscope NAME="N0Element7> 
</ifhasrepeattargetscope> 
</_TDEBIock_> 

30 
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this resulting DOM tree is as follows: 

<ElementLlst> 
<NOEIement> 
5 <Elementindex="17> 
<Element index="27> 
<Element index="37> 
<Element index="47> 
<Element index="57> 
10 <Element index="67> 
<Element index="77> 
<Element index="87> 
</ElementList> 

1 5 Note the DOM tree would not change. The 'addattribute* does not get processed since the 
'ifhasrepeattargetscope' is trying to scope to an element type called "NOEIement" that does 
not exist. The else statement is then processed and a new element Is added. 

ifhastargetscope directive 
20 The ifhastargetscope directive behaves in a similar manner as the ifhasscope directive. 
However, this directive applies to the targeted DOM tree. If the targeted DOM tree 
contains the scope name the section of code defined within this directive is scoped. The 
else directive maybe used here as well. 

25 Syntax 

<ifhastargetscope NAME="sname" INDEX=Jndex_> 

sectionA 

<else/> 

sections 
30 </ifhastargetscope> 
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where, 

sname = target scope name 
Jndex_ = integer value 

5 Description 

The snanfie specifies the name of the scope. The Jndex_ value specifies if the element 
at the index value exists. The default value is set to 0. 

Example 

1 0 Suppose the model defines an element "Class" which has two other embedded elements. 

This document is called class.xml. 

<Class name="Set'*> 

<Method name="add"> 

</Method> 
15 <Method name="der> 

</Method> 

</Class> 

Also consider the following template: 

20 

<?xml version="1.0"?> 

<!DOCTYPE _TDEBIock_ SYSTEM "dtd/tde.dtd"> 
<_TDEBIock_ DOMTree="class.xml"> 
<targetscope NAME="Class"> 
26 <ifhastargetscope NAME="Method"/> 

<addattribute NAME="type">void</addattribute> 
<else/> 

<addtargetscope NAME="Method"/> 
</ifhastargetscope> 
30 <ifhastargetscope NAME="NoMethod"/> 



CA9-1 999-0037 



90 



CA 02311870 2000-06-15 



<addtargetscope NAME="Elemenf'></addtargetscope> 
<else/> 

<addtargetscope NAME="newMethod'7> 
</ifhastargetscope> 
5 </targetscope> 
</_TDEBIock_> 



this resulting DOM tree is as follows: 

1 0 <Class name="Set"> 

<Method name="add" type="void"> 
</Method> 

<Method name="del"> 
</l\/lethod> 
15 <newmethod> 
</newmethod> 
</Class> 



Note that the attribute was added to the first method. No element changes were made. 
20 Since the "NOMethod" was not found in the targeted DOM tree, the else statement gets 
processed and a new element is added called newmethod. 

createalias directive 

The createalias directive is used to define logical roots. These logical roots acts as 
25 pointers on a DOM tree. 

Syntax 

<createalias ALIASNAME="alias" ALIASPATH="sname"/> 
where, 

30 sname = target scope name 
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alias = the alias name that represents ttie logical root 
Description 

The sname specifies the name of the scope. The alias represents the logical root. Using 
5 alias names simplifies navigating a DOM tree. Furthermore, using alias names can make 
the template more readable. Alias names are globally visible just like macros. 

Example 

Consider the following source XML document: 
10 <Package name=MyPackage> 
<CiassList> 
<Class name=HondaCar> 

<Method name=addHondaCar> 
</Method> 

15 <Method name=removeHondaCar> 

</Method> 
</Class> 

<Class name=FordCar> 

<Method name=addFordCar> 
20 </Method> 

<Method name=removeFordCar> 
</Method> 
</Class> 
</ClassList> 
25 </Package> 

Now consider the following template file: 

<_TDEBIock_> 

30 <createalias ALIASNAME="HondaClass" ALIAS PATH="ClassList//Class[0]7> 
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<scope NAME="ClassList//Class[1 ]"> 

<cr atealias ALIASNAME="FordAddCarMethod" ALIASPATH="M thod[0]'7> 
</scope> 

<scope NAME="HondaClass"> 
5 <repeatscope NAME="Method"> 

$naiTie$ 
</repeatscope> 
</scope> 

<scope NAME="ClassList//Class[1]"> 
1 0 $FordAddCarMethod//name$ 
</scope> 
</_TDEBIock_> 

The resulting generated output is as follows: 
15 addHondaCar 

removeHondaCar 
addFordCar 

The above example defines two alias names. The alias name "HondaClass" defines a 
20 logical root that references the first class element in the DOM tree. The second alias, 
"FordAddCarMethod", references the first method under the second class. As one can 
see alias names can be used to jump throughout a DOM tree. An alias name can be 
overridden. 

26 
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TextC ntent 

Description 

An XML document consists of child elements that may or may not have a text content. The 
text content of a child element is represented by a macro called $TEXT$. Consider the 
5 following XML document. 
<class> 

<Name>Foo</Name> 
</class> 

10 A template file can access the text contents of the 'Name' element as follows (see Scoping 
Directive Section): 

<_TDEBIock_> 
<scope NAME='*class"> 
1 5 <scope NAME="Name"> 

$TEXT$ 
</scope> 
</scope> 
</_TDEBIock_> 

20 

The resulting emitted code would be: 
Foo 

The template file can get complicated if numerous text contents need to be accessed. A 
25 scoping rule for each sibling would need to be implemented. In order to improve usability 

a scoping operator can be used. This scoping operator is defined as IP. Therefore the 

above template file can be rewritten as follows: 

<_TDEBIock> 

<scope NAME="class'*> 
30 $Name//Text$ 



CA9-1 999-0037 



94 



CA 02311870 2000-06-15 



</scope> 
<_TDEBIock_> 

Positional navigation tliat is used in scoping can also be used with macros. This is useful 
5 in cases where there exists elements of the same type. This Is illustrated in the following 
example: 
<class> 

<Name>Foo</Name> 
<Name>Foo2</Name> 
10 </class> 

The following template illustrates positional navigation. 
<_TDEBIock_> 
<scope NAME="Class"> 
15 $Name[2]//TEXT$ 
$Name[1]//TEXT$ 
</scope> 
</_TDEBIock_> 

20 The emitted code is as follows: 

Foo2 
Foo 

25 If no index is given the first sibling that matches the macro is used. Similarly, each element 
can has a list of text contents. Consider the following XML document. 
<class> 
Extra Text1 
<Name> Foo</Name> 
30 Extra Text2 
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<Method>MyMethod</Method> 
Extra Text3 
</class> 

5 Each text content under an element is given an index value. This index identifies each text 
content so that positional navigation can be used to navigate the text content list. This is 
illustrated in the following template file. 
<_TDEBIock_> 
<scope NAME="class"> 
10 Name=$Name//Text$ 
First Text =$Text[1]$ 
Second Text =$Text[2]$ 
Third Text =$Text[3]$ 
</scope> 
15 </_TDEBIock_> 

The resulting output is emitted: 

Name=Foo 
20 First Text =Extra Textl 

Second Text =Extra Text2 
Third Text =Extra Text3 

If no index is given all text content within the element is appended together. 

25 
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Children Navigation 

The mechanism provides means to navigate an elem nts children nodes generically. For 
example consider the following tree: 

5 Elementi 

I 



I I 
Element2 Elements 

10 I I 



I I I I 

Element4 Elements Elements Element? 

1 5 One might want to navigate to all the end nodes of the tree without the hassle of knowing 
Element2 and Elements. Or one might want to repeat on all the children nodes of an 
element. Typically, in order to process Element2 and Elements a separate scoping 
directive would have to be written for each element. For example consider the following 
template file: 
20 <_TDEBIock_> 

<scope NAME="Element2"> 

$Name$ 
</scope> 

<scope NAME="Element3"> 
25 $Name$ 
</scope> 
</_TDEBIock_> 

Note for both Elements we are extracting the Name attribute. The template file can be 
SO huge if there were more children elements. Just like there is a predefined string to 
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repr sent a parent for an element (ie. ".,") there should be a predefined string to represent 
the children elements (ie. _TDECHILDRENJ, With this in mind the above template can 
be rewritten as follows: 
<_TDEBIock_> 
5 <repeatscope NAME="„TDECHILDREN_"> 

$Name$ 
</repeatscope> 
< TDEBIock > 



1 0 One can also navigate to a specific child node based on index. For example consider the 
following template file: 
<_TDEBIock_> 

<scope NAME=".TDECHILDRENJir> 
$Name$ 
15 </scope> 

< TDEBIock > 
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Tag Nam Content 

D scription 

The mechanism provides a predefined macro to get the tag name of an element. This 
macro is called $_TDETAGNAME_$. Consider the following XML document. 
6 <class> 

<Name>Foo</Name> 
</class> 

A template file can access the tag name content of the 'Name' element as follows: 
10 <_TDEBIock_> 

<scope NAME="class"> 
<scope NAME="Name"> 
$_TDETAGNAME_$ 
</scope> 
15 </scope> 

</.TDEBIock_> 

The resulting emitted code would be: 
20 Name 

Consider a list of students that each have a list of marks as represented by the following 
XML document: 
<studentjist> 
25 <student> 

<id>166443</id> 
<name>Sean Watt</name> 
<marks> 

<biology>63</biology> 
30 <math>75</math> 
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<chemistry>62</chemistry> 
<physics>66</physics> 
<english>78</english> 
</marks> 
5 </student> 
<student> 

<id>4457833</id> 
<name>Whitney Lee</name> 
<marks> 

1 0 <biology>88</biology> 
<math>78</math> 
<chemistry>82</chemistry> 
<physics>95</physlcs> 
<english>81 </english> 
1 5 </marks> 
</student> 
<student> 

<id>7641133</id> 
<name>Bob Barney</name> 
20 <marks> 

<biology>73</biology> 
<math>92</math> 
<chemistry>83</chemistry> 
<physics>76</physics> 
25 <english>83</english> 
</marks> 
</student> 
</studentJist> 

30 Suppose all the biology marks and math marks are desired. We can write the following 
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t mplate to extract this information from the above document: 

<_TDEBIock_.> 

<scope NAME="studentJist"> 
5 <repeatscope NAME="student"> 

<scope NAME="marks"> 
<repeatscope NAME="_TDECHILDRENJ'> 
<if 

EXPRESSION="(($_TDETAGNAME_$=="biology")| 
1 0 ($_TDETAGNAME_$=="math"))"> 

$TEXT$ 

</if> 
</repeatscope> 
</scope> 
15 </repeatscope> 
</scope> 
</_TDEBIock_> 

The above template file navigates down to the mark element and then navigates through 
20 all the children elements under the mark element. An if statement matches the tag name 
of each child element. If any of the child elements are equal to "math" or "biology" the text 
content of the child element is extracted. 
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The resulting mitted code is as follows: 

63 
75 

5 88 

78 
73 
92 

10 Comments 

Comments help makes the template files easier to read. They do not get emitted in the 
output file. A blank line on the other hand will get emitted in the output file. 

Syntax 
15 <!" comment -> 

Example 

The following are some comment lines in the template file, 
<!-- 

20 This is a template file 
— > 
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The embodiments of the invention in which an exclusive property or privilege is claimed are 
defined as follows: 

5 1 . A mechanism for manipulating information from a source data model and creating 
a target data models said mechanism comprising: 

(a) a template module including a directive to manipulate selected data in said 
source data model; 

(b) a template processing module to process said directive contained in said 
10 template module; 

(c) said template processing module further including a component to generate 
a DOM tree for navigating said template module to manipulate said source data model. 

2. The mechanism as claimed in claim 1, wherein said template module further 
15 includes a directive to create a target data file, said target data file providing a repository 

for data obtained from said source data model. 

3. The mechanism as claimed in claim 1, wherein said template module includes a 
directive to manipulate the DOM tree. 

20 

4. The mechanism as claimed in claim 1, wherein said template processing module 
further includes a component to generate a DOM tree for navigating said source data 
model. 

25 5. The mechanism as claimed in claim 4, wherein said template module includes a 
directive to manipulate the DOM tree for the source data model. 

6. The mechanism as claimed in claim 1 . in an application development program and 
said source data model and said target source data model define an object for an 
30 application program. 
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7. The mechanism as claimed in any one of claims 1 to 6. wherein said template 
modul is expressed in XML, said template modul being defined according to a DTD. 

8. A method for manipulating selected data from a source data model, said method 
5 comprising the steps of: 

(a) defining a template file having a directive specifying the data to be 
manipulated in said source data model; 

(b) generating a DOM tree for navigating said template file; 

(c) navigating said template file and applying said directive to manipulate 
10 selected data in said source data model. 

9. The method as claimed in claim 8, further including the step of creating a target data 
model, said target data model providing a repository for the data obtained from said source 
data model. 

15 

10. The method as claimed in claim 8, wherein said step (c) of applying said directive 
includes generating a DOM tree for navigating said source data model. 

1 1 . The method as claimed in claim 10, wherein said template file includes a directive 
20 for manipulating the DOM tree for said source data model. 

12. The method as claimed in claim 1 1 , wherein said template file is expressed in XML, 
said template file being defined according to a DTD. 

25 
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13. A computer program product for an application program for creating objects, said 
application program including a utility for manipulating information in a source data model 
and creating a targ t data model, said computer program product comprising: 

a recording medium; 

5 means recorded on said medium for instructing a computer to perform the steps of, 

(a) defining a template file having a directive specifying the data to be 
manipulated in said source data model; 

(b) generating a DOM tree for navigating said template file; 

(c) navigating said template file and applying said directive to manipulate 
1 0 selected data in said source data model. 

14. The computer program product as claimed in claim 13, further including the step of 
creating a target data model, said target data model providing a repository for the data 
obtained from said source data model. 

15 

15. The computer program product as claimed in claim 13, wherein said step (c) of 
applying said directive includes generating a DOM tree for navigating said source data 
model. 

20 16. The computer program product as claimed in claim 15, wherein said template file 
includes a directive for manipulating the DOM tree for said source data model. 

17. The computer program product as claimed in claim 13, wherein said template file 
is expressed in XML, said template file being defined according to a DTD. 

25 

18. A computer program product comprising means for instructing a computer to 
perform the steps of any one of claims 8 to 12. 
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Figure 2 
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